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® MettKxJ and apparatus for remote seortce of a host system. 

® '^J^n ^ integrated Into the operating system of the host system being 

supported. The BSF unit ubSzes a standard generic menu Interface system (GIVIIS) unit through which a user 
can enter different types of commands which results in the display of a number of menu sequences for 
configuring how the different independently controllable components of the RSF unit win operate in perfornilng 
remote support functions. The components Include a problem detection and reaction component, a system 
action component and a callback component each of which operatively couple to the GMIS unit The 
components are integrated in a predetennined manner so that collectively, they carry out remote suooort 
according to the way In which thoy were conHgured. nr remote support 
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system duHng normal operations and more partlcularty to methods and systems for providing remote 
maifitenance arui support servfces for such rwjk ^ V / J 

Numerous kinds of systems have been' develof)^ the years fey- maintaining anil dia^K>str)g' teults 
occurring wthin data processing systems either locally ore remotety. Such systems have taken the form of 
system managenient apparatus, maintenance processors and remote mfdnta^n^noa^sys^^ and 
systems. Examples of these types of systems are discussed In U.S. Paterii 1(0^4,^,935, 5,202ii&3, and 
5,210,757. 

Also, sottware components t»ve been used to prwide remote Twp(^ t>ost systein^ One such 
system disclosed in U.S. P^ib^t ^tc>• 5,1 1 1 proUdes^for automating ttie dump analysis i^vce^^^ Another 
type of system nwiHbrs a system eiinof log to detebt problems and automjEUfcally caJj^ a' rerrurte ii^W 
diagnosis and corrective aciibh. An e)campl0 of this system is the lembte mairi^inar^ manager'^ (RMM^^ tool 
developed by 6ba HN Intormatfon Systorns Inc. vrtiic^ 'is d^n1c>ed in 
ReiTwte >iU^ 

arKi having Order No. LVVa7^)6. 

The reimote maintenance m (RMM) sut>system k^l i^ implemeridte^ as a sfngle cornpone^ 
Is integrai^ Into it^ oj^sdting system the host s^stem^ The^ toot liiclt^ (bsckgr^ 
process tfiiiat is initiaUzekj-by ah Inteiiace pr^ riui by ah 'iidmlni^r^ 
for ttie RI»ifM subsystem': il^S Pr°<?^ ^^^^f'!^ *P f^P'!*^ ^ .^i^^^ 

eskbhshed thirbugh^ cMcekfing^f^cie^^^ r^porxte by to a 

response^ center vvf)en^{ui estabOshed'tl^^ exce^^ ' J"''''^;''',.!^,'^'; ''''*' 

' Upon receipt of ''''thi^'''C3ll£^^^ ^and^^ aco>mp^^ _ message; ' a ' renwte o^^k^^^ is ' able to ' determine the 
source of the caltoiit by e^mi^ m^'sKsage'^i^ i^lM jk'r^^ the adrn^^ is 

informed of the actidn bjr r^w^pt of a mail me^sa^ Aisor.th^ ' r^ op^TGdor' wft^ a mes^gie tx> in& 
administrator's console noti^ the'^ai^minisb'atc^^ to ho'k sys^ ^yiji^ 

remote operator. Six4i icdiback tialces'^ ttw 'Wrm ' c^ lognirig onto the host system's 

operating system fadWies wtierein the remote operctor initiates a .remote sessloi^ . ^ ^ v . 

If 'the' ' 'adnnir^sSator; ''heeds' '*t6' tejrmtif&te ttieT [repiioiBt '\ session, %e '^sS^r0^Tsl\^ oht^ ^ ^^^W^ 
command Via the cons a)mmuni£ate vWth 'the logged on iremb^^ standard qpers^hg 

systeirf utifibes.- 'V'""?-' " 'T'Z^IX^'^^^^^ 

this type of syi^tem is very infta^dble in jts^^^^c^^ ara dlc^ed^ by a set of preid^f^ed 
sequenced of bpera^^ whidi asjsumes ttie exIsteiK^ ^^^c^^^ holsi aystetm 

conopor^ents. . , - , . . ' -1" ' , ' " .■ V '- ' ' ' '. ' '■' - '1^",,'.'" ' '7. ''i'T " , J! ' . ■. 

>ivhh more arxl more vital infomnation database being entn^sted to]c^ sccess and 

secuirtty of such tnformiation Is.of the utmost importenc© tis®!^'- -^M^ wrori.be 

detected and corrected ^h6ttt delay tei'preymt imy ^ |^:user 
there arise cbinfiicte'betWeen ttiese two rck^drements. AKroi /^nicei s^^ 

installation to instanation, there coutd be a variety of different needs to satisfy, ranee, Jt is de^sirsijfa ^at^t^ 
user be able to have a oertkln degiree 6f bonjtmt <^ liiw remc^^ support Is can^^ 

An area which should be dislinguisheKl rebtiye to rerrMote 
to network mahagemi^ whk^ jprbxHde fc^ harjdlinigi (k^ eyente^oq^^ 
tions networic Network mana^emcm^ loc^ or re 

resource arfei other cofruTnurricatlpns d^c^ ascertajhing 
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It is a further objeict of the pfesent invention to proi^de a remcrto lipport system in which an 
adminisfrator has greater .control over the host, system during the peifomiance of remote support oper- 
ations. ' H 

rh& above objects and advantages are achieved In a preferred embodiment of the present Invention by 
a remote service fadKty (R$F) unit which is integrated into the operating system of the host system being 
suppated. The RSF unit utilizes a standard generic menu Intertace system (QMIS) unH which is included as 
a standard, part of the host operating system. Throg* tftis Interface, a can entbr different types of 
in the display of a number of menu sequences fdr;corifiguring Ikm the different 
'"^®P^e"«y. controllable components of the RSF unit wilt operate in peifdrSJirig romot^ suppSrt'finKtioiw 

In the preferred embocfiment. the RSF unH comprls^ thr^ SofKi^w^ can^'lig oirt^the 
ba^ functtpns required for performing renr^ote .^support. These are a pr^em deteciiiSn and reactton 
OOTiponeirt. a system action <»mponerit and a callback cbmpinent each V irt^ op^l^y ooupie to the 
QMIS unit Each cornpwent is independentt configurable and Includes oxtf^^ meam for' s^ 
^figuretfpojnfor^p acDBsse^ by the compor^m .v^ 

its partlcul^ function. The components are irrtegrated m a V^stennln^ marinw so^ t^ tfiey 
carry out remote support according to the way In wtiich;tt»ey ;w^^ci^ ' ' ^ ' ' ' ' 

T|ie problem detectipo and rea^ component f)er^^ a'nmb^ of host 

enror tog fil^ sources for detc^^^^ 

^eafied^ a^^^ tt^e f0en^ ernbo<^^ Indlxles moduli' ^for 

perfonning di^rent typ^^ of i^ppprt modincation, at^ in 'r^ a sou^ over 

perfonned when an c>verttv^(*i^ ^ 
prppessing c^te from tfie, support center.ma^ i^^ 

proWem detection a«d ruction for plirppses .<comS^ ^ 

The approach utiHzed by tl>e present invention Is that of d^fihing a minknum number of baste functions 
required to perform me. rempje support fMrrcftpn and ,if^ MtiHze a corresponding numbed of Imi^n- 
dentty operabte compon^its for^^^c^ out. ttiosS; M^^^^ opeiBlively 'ojupied in a 

manner so as to collectively peiteim'rem^ 

Thte appro^ m^tes H to mawmize^^the (^^ of ea(^» component AdtfiSonafly, the 

approach enabtes different^^c^^ to be InsSted^ v^^^ ijffe^ 1^ 

system commurwc^ a>nfiguratio*is su<* ae^aiiilbi^ a^ F^rth^, the ^range- 

ment faalitatos the adcHtbrj of lieW capatjilitl©s,w hr^ir*^^ to compete. neW i^ new 
host systwn configurations wWiojU^n 

In thi preferred emlwxSr^ comportem operate^ or 
background program, which <an bo. enabled or configured for ! oper^'n through fte GMIS unit The 
configurations for components can be either preioadiki or mbiJifi^ duifeTg Installation (he unit's 
components M requir^^ 

Considering each cornporwnt in more |^«iW terri« relative to preferred embodiment of the 
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bdng monitor^ thereby redudng ho^^^ 

Also, in accordance vdth the present invention, the configuralibn means <^ tie ifeed to configure the 
problem detection and reaction connponent to 'iw^ lib inMled in re^ionse to 

detecting an over threshold condition on a paiaoiiar sourc^^^ the problem detection and 

reaction component from the bperatton of the sysfwj action dacnponont theioby provitf ng greatef flexIWHty 
In prescribing what actions should be taken in a giveh coje ^ Weil as the option to take no acBon in certain 
cases. Thus, a variety of different options can be configured. In me prcrtwred emtxxjflment. this iw:ludes 
caltout via local or through shared communicalions faciHties and maiVrwtiiicafiott actipi^. 

The configuration means of the systern acdiw) component of tii preferfeil emtjodsimenl can be used to 
support the actions mentioned above through the fadlitieS 6f the host sy^. Adcfitiiwiahy; such m^s can 
be used to support the support notifljc'atlon actions for iiandaldne aid cluster hoS coofiQuratioiis (i.e., 
duster cUent and cluster server), in the standalone configuration. Ifw c^l^ carried'out by a 

daemon proce^ which manages the execution of callout ^requests entered into a caMput manager queue 
using the coifnchunlcation fadlittes (modem) of the host systwni lrj toe cluster awiflguraijion; the callout 
function Is carried out through shared communication fadtities udng ckjstor ctient/server software' fadKtes 
Installed on the different systems wfiich rn^e up the dustar. ^^1 additional daemon prc^ used to 
manage such shared comnriunlcations requests- , 

Also, the managing of the callout functloifi in fernis of how tt is executed can dso be configured. It is 
possible to select the type of response center communications protocol to, be used in pomrnunlca^ a 
callout action and provide the appropriate liarawietere to a response ceiitor^ s^^^ unique host system 
identification inforniation for enabling the selected renkjte cJenter to respond prop^ to such caiioot 
request a comprehensive list of response center phone numbers, to.be tried in, sequence^ until a successful 
connection is made, remote password information to be usS^ By ttie 'yin&-iri rBsporwfi 
an electronic mail address to vrfilch notification of ttie canoirt action fe to be sent 

Also; in accordance; with the pr^sont^ ^ ^rat^ ^^ 

can be used in specifying a comprehenshra s^f 1^^ pararneters for Wk>tishing a commu- 

nications Knk via a laro^ riiSntiei- bf'dlffefertfti?f^^^ (OK) iwte 

strings and connet^on byta :stiir^ j^rther 
enables configuring crther paramel^ as the niifiiber to'Se m^e, for eadh V?one num tf>e 
delay between busy tfes arid oo^nmiS 

matcf^ng ttie banoul action to tho type of host sjMe^ roiources to tfeitiRTOd jn making' and reispoix^^ 
the callout tonctidh b an effidenta^^^ ^^'1 ' '" 'i' / ' " 7 ^ 

In accordance with the present invention, tf^ .ccoBg^a^n means of caJibai^ (Mmpwienl enables 
remote access by a responiw 

selection 6f a wjmbo^:,**' 3^ 
administrator of the host iaystenS to view of M acSibns b!Sn^ by'a'rOTote In tois way. it is 
possible to maintain the security and integrity of host system 'clata as well as capmrfng'for later viewing all 
actions taken during a gK^n^assion In tlW perf^^ of the reriSote suf^ function. A hir^ 

feature of the callback comix)ftent . is a hot key capaWlify whteh allows ti?ie admini^irator to lrr»medlateiy 
tenninate any cunrert s^ion^by the reri^ 

The above o*^f;o^^ embodiment 
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organization ihe menu system ufiiized by the generic menu interface system 

of Rgure 1 in accprdarice with the present Invention. 
Rgure 7a illus^tes a sampie sequence of confl^^ 
Rgure 7b illustrates in greater detail, the Install ofj^^ Rgure 7a. 
Rguro 7c illustrates in greater detail, the source ootI^^^^ of Rgure 7a. 

Rgures 7d1 through 7d4 illustrates In greater the calioixt configuration operation of Rgure 7a. 
Rgure 7e iRustrates in greater detail,' the set syjstom identifler qperelkxi of Figure 7d 
Rgure 7! illustrates in greater dertail, the conjure callback operation of Rgure 7a 
Rgure 7g illustrates in greater detail, the configure ifK>nitorif)^ operation of Rgure 7f. 

Rgura 7h iHustrates In greater deteil. the configure diagnostic operetion ol.Figure 7a, 
Rgure .71 illustrates In greater detail, the configure daemons operation of Rgure 7a. 
Rgures 6a through 81 illustrate menus utilized In carrying out the configuration operations of Rgures 7a 
through 7d. 

Rgures 9a through 9c illustrate menus utilized In carrying out the configuration operations of Rgures 7f 
and7g. 

Rgures 10a through 10d Illustrate menus utilized in carrying out the configuration operations of Rgures 
7h and 71. 

Rgures 1 la through 1 1d are flow diagrams used in describing the operation of the problem detection 
and reaction component of Rgure 4a. 

RgUres 12a through ISd arid i3a through 13d are flow diagrams used in describing different functions 
performed by the callback cornponent of f^re 

DESCRIPTION OF HOST SYSTEM OF FlisURE 1 
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Figure 1 lUustrales the use of the i^mqtp seryic^^ (f^SF) .unlt of the present Invention in a 

standalone s^^em environment As shpwn.^t^^ a host .system. 10 coupl«l to a 

communJcattorts Brik >^ 12 for ck^eO^^ dW put ac^^ rernotely k)cated response center 

14 or a technkia) asi^staiKe center (TAG) as we^'as cfiai In access for operations. As 

shown, the host system 10 ,ir>dud(M a hipirt corn couples to a rnain 

memory 10-3 and to lnput/oOt;)irt koirege idevlc^/ si^ ^The disk fiies 10-16 provide 

storage for the different Ctes utilized by the BSF wift of the present hwentton.. For the purpose of the 
present Invention, the host computer syistem Is coiWen^^ of the pPX/20 

system marketed by Bull HN Information Systerns Ina ' Z , \, 

A user can dnrocWy acce^ ttw cornputwj^s^^^ a terminal pr.tecal console 10-14 while a 

system administrator Is able to access systein 10^2^ t^^ administration .temUnal or administratkm 
console 10-12. As sho^/ €iach of the cc«sofes':iaKt2 and 10;-14 includes aTdlsplay device^ keyboard and 
optionally, a pdntihig devtea such as a mouso. ' . ' 

Tl>e system 10-2 Is operated under ttw opntrol of a UNIX based software system 1(M whteh includes a 
UNIX based operating system or kernel which controls the computer system 10^-2 and provide a system call 
Interface to all of the programs rurining on the s^em. Tlie systern, yChA also^^inciudes a library for storing 
procedures for processkig such system calls (one pro(»dure per iaill) a large number of standard utifily 
programs such as the .command processor or shell, compilers, text, prpces«'r>g f^ and file manipula- 
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As IndJcatet^. anif further detaY liie^ diff^t comp^ is 

configured for dient host sy^ems and the server host system directty connected to the modem 12 which Is 
to t)o shared by' the cfierrt host systems. In s^tem cciiliguraaon^ originating on a * 

client host systwri is able to ^i^^ the to make the caJIout request 

DESCRIPTION OF RSF UN IT 10-10 I 

• —r: ^-T— ^ , 

-V ^ . ■ ' 

Figure 3 shovirs in block dejKan) fpnrin, tfie^ packaging structure and major components of the RSF unit j 
10-10. As shown, the B|5F, unit j^^^ fibljowing ifouf subpackagi^ a, problem detoctten and 

reaction sul)package 10:100; a ^^^^ IQ-aOO. a cluster, services subpackage 10^300 ! 

and a cailback pnviroi^ As a function the type of system InsteltetJpo. different 1 

ones of these subpailaages kistel^ host system 10-2. The below, table stuyws . which 1 

subpackages are iristalled for ttie* stand aiooe, duster cfient and chjsler server system conifiQuratfon i 
illustrated fat Figures 1 and 2. 



TABLE 



Type of System Inst aflation 


Problem Detection and 
'Reactu}n Subpkg. 


Callback 
Siibpkg. 


Systehri Action 
(Autodial) Subpkg. 


Cluster 
Subpkg. 


Standalone 
Cluster Client 


. " '.X " ■ ■■■■ ... ■ 


X 
X 


, .::X; ^^,-,v „ 


X . 


duster Server/ 


/"'Mi':-" 


X 




...v-.-X,,.,.- 



As lndk:ated by the table. In the. standalone system of Figure 1, subpackages 10*1 Oo; 10-200 and 10- 
400 are Installed. In each dienl system of Figure 2. subpackaigjes 10-100; 10^200 and 10-300 arb ln^led. 
In the server system of Figure 2. a« of the subpackages .10-1 00, 10-200.^^10^ 'and 10^^^^ Ihsfelled, 
Each of the subpackages will now b6 consfdered in greater detail. As show b Rgiird 3, suttpackaige 

^ 10-100 includes the problem detscttoh and reaclfoh cbmjwhent of unit 10-1 01- This ^(^^ oJierativBly 
couples to GMIS unit 10-8/ to: administrator console ^iO-^ aiid to ^ tocsd cdiiso^^^^^^^ f6r recei^ng 
commands therefrom. As ' showa componem ^^^^^^ sigrwls to/sy^^^ a^ 

subpackage 10-200 and duster subpackage 10^: This corrifwnWt^^i^ to' monitor cl^^ 

types of sources such as the host sjrstem^^^^ any ASCII lt>g We gwera^ aj^Katlon 

^ running on host system 10-2. > r ; 

The component 10-100 include a plurality of databases and log files repiBsehted by btock 10-102 
whteh are accessed via routines contained , within a RSF -fibrar^ 10-104. ^A number of command prc^jrams 
included wttWn bfcxk 10-106 execute the different types of cbmrnands receh^ed from GMIs unit IM and 
consoles 10-12 and 10-14 utifizfng the Tibrary routines ol bk)ck 10-104. Additionally, cbmpoiwit 10^100 

^ Includes a rsfd daemon lOrllO whteh also accesses certain routines of Pbrary 10-104 for performing certain 
operations such as diagnostic cadout operatfohs discuss^ herein. The rsfd d^ernon lOi^fip^ 
configured sources to detect when messages reach over tiireshoM conditions and exmHes those t^iie^ of 




75 



20 




20 



30 



40 



45 



f iw-s*iw;«iiuAHio-^iiouiuiu/netcaU 
la t e d i ff ere m jnstel ^ feq u l re fnefi te;^K w » 10:2 1 ^ liG^214;- 1 
216 and 10-218 are also Included In component 10-300 and con-espond to mcihiies 10-312! 10-314, 10-316 
and 10-318. The modutes netactd and netcall are used in duster server and ciu^ systems, 
respoctrveiy. When configured, the component 10-300 operates to carry oU caHout operator for cluster 
system configurations via the local area network and operating system corhmunjcatiOMi facilitites tlk/strated in 
Figuro 2. 

The callljack sutipackage 10-400 includes the callback component of RSF unit 10-10. The callback 
subpackage 10-400 operatlvely couples to the inodem 12, QMIS unit 10-8 arid to console 10-12. As shown, 
component 10-400 includes a mirroring subcomponent 10-402 ahd a p«9rrnis5ipn control subcomponent 10- 
422. The subcomponent 10*402 can be config^d to carry wt'a pktraljty of diffwent mlnroring and scripting 
operations which enable an administrator to observe all of th^ operaSw canted out by a remote user who 
dials into the host system 10-2 from TAC 16. TTio permisskii can be 

configured as deisirBd for security purposes to control remote acce^ td^^^^ facilities. 

PROBLEM DCTECnON AND REACTIOH 

COMPONENT 10-100 - Figure 4a 

Rgure 4a shows in greater detail, the problem detection and reaction component 10-100 of the present 
invention. The block diagram Indicates the operative coupling between the different programs and files 
utilized by the component 10-100. As shown, block 10-106. Includes comnnand programs 10:i06;a throjgh 
1 0-1 06k and files 10-1061 and 1 0-1 06m; Those programs are invoked tfirough a command fine generated 
either via GMIS unft 10^ or console 10-12, With the exception of command ifiro{^^^^ tlwse 
progranrvs acoBss one or rnpre routines contained In RSF library 10T.104.as a fijhction of the parameters 
contained in the command line. The program lO-IOBa also receives an input from the system 1(M and the 
user generated (xnfiguratipn fie 10-106m. As discussed herein, program 10?108a generates the initialization 
nia 1(>-106l ,whk:h can be used by prograrns 1^^ 

As shown, ia)rary 10-104 irtdudes a plurality q of routines I0rl04a through 10-1 04k which wiU be 
discussed In grMter detalj , herein. The routines 10-i04a through lOrl 04k described in greater detail in the 
apperidbc are used to manage.the contwits of the dataljaso files and tog files of Wock 10-102 as indicated In 
Figure 4a, As shovyn, the database files 10-102 -include an. action ? tog -file; 10-1 02a. a control or source 
attributes file 10-Ip2b, a message template, databases file lOrl 02c and, a stored, messages (keep) database 
file 10-1Q2d. The source log files include any numttor of system en:or tog files 10^1 02e and ASCII tog files 
10-102f. Additionally, btock 10-102 Indudes a diagnostto. configuraltonvfile 10r102g used.by rsfd daemon 
10-110. 

The actton log file 10-102a, shown In greater detail in Rgure 5c, Is used to maintain a record of acttons 
lor one of the system error tog files 10-102e designated as "system." As Indkated in Figure 5e, each action 
Includes the data arid time theadton was initiated, the path of the action program, the result of the action 
(successful, unsuccessfuO and a description of the paitfcular action performed (ag. caltout). 

The control or. source atm*butes file 10-1 02b is shown In ; greater detail in Figure 5a. As shown. It 
contains one record for each source (tog file) being monitored by RSF unit 10-a Each such control record 
inchjdes an Wentifier fieW specifying the user's name for the source, the path for accessing the source, the 
ac^^-t>e42^ 
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such as unknown, temporary (transient) and permanent (hard). ! 

The class field indicates whether the error Is a hardware (H) or software (S) error. The error de$criptk>n 
field proAodes a description of the enror condit^ 

The ASCn log file Jnchides fines of tB>i.s«^^ ^y ,'^^ I'"® characters as shown in Rgure 5e. The 
text fines can take any forrn. In the case of cloc^^^W^ it was convenient to indicate the date, time, source 
and ctock'^ljustments. ' Ti'V' . ' ' ■ - ^-c-v. 

ConsWering the comm^ programs , of 1^ iri greater detail, the make rness^ template 

(mkmsgtmp) command prt)Qram 10*l()tojallow«, f^^ an inHiafizajBon file 10-1081, which contains 

groups of messages to t^ at^ek jo tf]kel rneusi^e tempiata^ datat>ase file ld-102c for a particuiar source by 
programs 1O-106b. 10-1C>6c' arid ) 6-1 oise deM messages to l>e monito^d for oyer threshold 

conditions. = ■ 

In greater detail, the mknj^gtrnp prb^aum |0-1|^ roads In the standard inpiil from a host system utility 
progranri nbrmalty used to |Kint out all of .tt^B^r^^ templates uQlteed by ttia operating system 1(M 
which contains informattoh for all possible error messages which can be utiBzed by the host system 10-2. 
The user can set up valu^ in. tables wimin tfw corftgw file which specify particular parameters, such 
as threshokl. duration, feebpma* yiues, fix^^ j^^ types of potential onror messages. The 

foltowtng Is an example of such a cpnfigur^^ 
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When mkmsgtmp program 10-1 06a is invoked, it reads entries from system 1(M. examines the 
configuration file tables to determine which parameters the user has specified for that particular potential 
message and writes a record in the InEtiallzalion file containing that potential message with the spedfiad 
pararrwters. The mkmsgtmp program 10-1 06a is used for tfie cfeatk)n of system source initializatiori files 
only. Bcampfes of such initlansation files are as follows: 
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As expldned herein, the command proerams 10-I06b, id^lOSc and 10-106e can be Invoked in a vray to 
use the contents at the initialization filci 1(V-10BI to add i gfoup of records at a time conlaihing potential 
messages to a messaQe template dalaijase indudetj wittiin block lo^ioac An exar^ple of tt^ type of 
information written into Ihe message template database is shown in Rgure 5b. 

The mkmsrc command pn^ram IO-ioOj in rispiii^l iS an midm which is generated by 

"""^ ^'^^^ Wtjates the of>erapri bfd^^^^ a new s6ii>ce to be mbnitored by 

^ J^«,^ * '^'^ ^ ^'^^'^jj^-}°9 m- Tiw'micmsfc comrnand described in 
greater detail in the appendix provides the necess^ p»amete« In k' g^ command DnW. The 
mlonsrc program 10-106b parses the command line and peilomis the necessary error cheOdng operations 
tor validating the command line parameters to ensure *si source Is vanS;' !! then aocas^ the control 

' «ilhita>w hto 

the control file datsbasa 10-1 02b, . ; - v - --.^ 

If the command" One includes an InitlaJizatkin iiie pai^eter opti^. this Causes mkmsrc pibgram 10- 
lOH) to access ihe search routines of libray 10-104 hi wife the' r^i^s fi^lously stored In MsWlzaUon 
file 10-1061 containing all of the potential messages to be' monitored for' a parHcular source' into the 
message template database iile of block 10-102C. The, result Is a database such as shown in Figure Sb. 

Cont&wiog with the other- commands that can uSiize initiarizafion file 10-1061, the chmsic program 10- 
106c anows irodBicatkMi of (he message attillMitM of a partcular sounw (ojo. 10-I02e or 10-102fi beino 
monitored utfllzing the control routines of B&aiy io-IM, This ^^6^ is invoked in response to a chm^ 
command with the appropriate command Hhe; such ^ describ^*:in the appendix. If the Command flne 
<^>«"«ter. «^ ll.'n.sm Pfogrini lO-IOSc accesses the.search reudnes 
11 ^ "'^'^ 10-106C causes the record #tenls of the source's message template 
database to be replacad with the nnessages previbiisly stbfea in. Wtlallzaflon file 1O-106I. It will be 
appreciated that wittt few ex(^ns.;the inform^on cqntabied in Mtiarizathxi file 10-1061 and intormatton 
contained In the source's message template databaro is the sa^^^ except for the foitowina 

rtffeierices. The InitiarizatkNi file is in human readat)le fonwrt. while Ihe'message template database Is in 
l*>ary format The message template datebaw als6 cohtains Information which is initialized to zero 
when the messages are added. ' I swo 

TTie last command program whfch utilizes Initialization file; lO-l 061 is mkmsg program 1O-106e Tills 
program enables a message to be added to' a sjaurclB's.meMage template database utilizing the search 
routines of library 10-104. TWs program is invoked In response to a mkmsg commarKl with the appropriate 
command line such as described in the appendbc If the cbminand ffiie ihckxies an initialization file option 
parameter, then mkmsg program 10-106e via the search routines, idds the messages previously stored hi 
inibaiization file 10-1061 to the source's message template database. 

T^o bmsrc program lO-IOOb allows Information pertaining to one or more identified soukos being 
monitored by unit 10-10 to be displayed or printed using the control routines of fibrary 10-104 TWs 
P^f^y^^^M "esponse to a Ismsrc command which generates an appropriate command One such 
as descnbed m.the appendix. lUe program lO-IOOc im^okes various routines contained in Ebrary 10-104 tor 
*^.^?Jll!^*^ contained in actton tog 10-l02a and control fito 10-I02b. to be displayed or printed 
ie.5P§ci!iad.by-thej»mmandJine-parai»^ H.»y»u w pnnwa 
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updates the message template database Wfth all the changes made to the message, ft also updates the 
keep database 10-102d as required so as to properl/ reflect and be consistent witfi such changes (e.g. if a 
new threslwVd value Is tess than the current count, the appropriate keepbase record entry for that message 
is cleared). 

10 The rmmsg program 10-106h is used to remove a record from a message template database thereby 
stopping RSF unit 10-10 from monitoring a particular message for a particular source. This projgram b 
invoked in response to a rmmsg command with the appropriate commarxJ Bne parameters such as 
described in the appendix. TT)e program 10-106h in turn invokes tt>e< appropriate routines In fibrary 10-104 
which renuKve the message firom the message template database of block 1O-102c klentmed by the 

?s command One parameters, in adcGtion to removing all messages stored la the keep database of block 10- 
102d having the same message klentifler. 

The chrsf command program 10-105 is used to start and stopAshut down the opeFatk>n of rsfd daemon 
10-1 10 and netactd daemon of cluster service component 10*300. This program Is Invoked ki response to a 
chrsf command whh the approprfale command line pararheters described tn the apperidbc. VA)en Invpked, 

20 the program 10-106 accesses the PID routines in library 10-104 for accessing the RSF PiO fife to detennrklne. 
if the rsfd daemon is rvnntng. The program 10-1081 Vien initiates the^appropriate dctkm to start or stop the 
daemons as specified t>y the command line parameters; - For the purposes of tfte present invention, the 
daemons are started arni stopped In a conventk)nal manner uslr^g the facili^es of system 10-4. 

The confdiag program 10^106] allows configuration of: a dtagnosticvcalhHit feature Wiich enables caHout 

25 action to be Initiated at selected Inteivals such as daily/ weekly, biweekly, monthly or bimonthly. This 
program Is invoked in response to a^confdidg cormnahd^v^ the appropriate cbmn>and Una paranietens 
described in the apperKlix. When invoked, ttie program accassas the appropriate routines in Bbrary 10^104 
which enter the frequency at which a diagnostic message is to be injected' into the>system error fog 10- 
102e as designated by the command line parameters into' the diagn6stte:conligurali6h>fi^ add the 

30 diagnostic message to ttie system tog source's message template database; < ' . r> ! v> ^ ' 

The rsfstat program 10-106k allows the status or configuration of the daefTK>n3'utiHzed by'RSF unit 10- 
10, This program is invoked In re^nse to a ■ rsfstat conrwnand with tfie appropriate "command line 
paranr>eters d&scribed In the appendix. When invoked, this program accesses the 'iaipprt)^^ routines in 
lil>rary 10-104 which determine through the PID files whteh daemons wnning and displays sijch status 

35 onhostsystem 10-2. There Is one PID file for each daenw. 

PESCHIPnOW OF RSF DAEMON 10-110 

The rsfd daemon 10-110, for the purpose of the present invention, operates in the bacltground Rke any 
40 Standard daemon running in a UNIX-based operating system. As discussixl her^h^ Tsfd daemon 10-110 
performs checks on message sources and when necessary executes preconftgured actions, tt also 
maintains the message template search database, keepbase and action fog files lOrl 10a, 10-101aVlO-102c 
and 10-102d. Accordingly, daemon 10-110 maintains a Ust of such managed message sources Indudif^ 
information such as (tie control record and ojpen file descriptors for the template search database and 
45 keepbase. in addition to using certain ones of the library routines, the rsfd daiemdn also uses a hwnber of 
its own routines. These Include event routines, action routines, signal routines, inrtializaliori routines, source 
_s©^_rcm&!eAi:ke5^fea^:j^ 

50 f6r:aclHin^pr^^ ■# ^Sifls^it^^ . 
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s t:t;:ifer fnie;ikgept^> sejafch ; for ovefmreshoid refrors for a 

source starting at tfie beginning of the keep database. TTie diagnostic routine writes a specified message ! 
Into the system error log file. 

SYSTEM ACTION COMPONENT 10*200 

10 

DETAItro DESCRIFTIOH - FIQURE 4b 

Rguie 4b shows in greater detail, a portion of the system action component 10-200. More specffically. it 
shows the modules which make up the callout manager module 10-210. These modules cormspond to a 

/5 make call (mkcall) module 10-210a, a calW daemon 10-210b. a file 10-2t0c contaJring a set of call control 
file access mutines. a list call (Iscall) module 10-210d, a change caH (chcall) module 1Q-210e, a remove 
(rmcall) module 10-210f and a call control (cailctrl) file 10-210g which are operathrefy coupled as shown. 
The tecaM module 10-210d allows callout requests stored In a calkMJt queue in file 10-21 Og by the caltout 
manager 10-210 to be Ksted. As discussed, caHout manager 10-210 controls the timing and sequencing of 

20 callout requests made to a response center. It manages the caltout requests stored In the callout queue. 
The callout queue is serviced by calW daemon 10'210b and parameters relating to the queue can be set by 
chcafi module 10-210e. This queue also can be manipulated by mkcall module 10-210a and oncall module 
10-2l0f. 

The Iscall module 10-21 Od is Invoked by a Iscali command with (he appropriate command fine 
25 paranwlers described in the appendix. .When Invoked, module 10-2i0d accesses (he call control file access 
routines of block 10-210c to read out queued caltout, requests for listing as specified by the command fine 
parameters. 

The chcail module ia>210e is invoked by a chcall command with the appropriate command ttne 
parameters described in . the appencfi)C When Invoked module 10^210e enables configuration of the delay 
30 and max calls parameters stored.ln file 10-21 Og and used internally by the callout manager 10-210 In 
controHing the pn)C^ng of.queued caflout requests. 

The nmcaW module 10-210f is invoked by a nmcall command v»rilh the appropriate command Gne 
parameters described in the appencBx. When Invoked, modute 10-2IOf uffliring the call control fite access 
routines of btock ;10-210c removes cailout requests from the caltout queue as specified by the command 
as tine parameters. . , 

The caBd daemon 10-21 Ob, as Indicated, services the queue by scanning it for wailing callout requests 
and executing the requested callout action by transmitting a callout record created by callact modute 10- 
218 via caltoutfcaDbin module 10-220 and modem 12 to the response center. 

The mkcail module 10-210a in response to receipt of a call actfon request from callact modute 10*218 
40 sete up a new record entry after determining that there are not too many cafiout requests waiting. It uses 
the command fine parameters received from modute 10-218 to be added to the caltout queue of call control 
fite 1Q-210g, It then updates its caltout count and next sequence numt>er In a call control header used to 
identify the sequence of callout requests. 

The other modules of Figure 4b will now be discussed in greater detail. The call configuration (caltefg) 
4S modute 10-214 attows the display and modification of ail of the various parameters in configuration fite 10- 
216. The module 10-214 is invoked m response to the calMg command with the appropriate command line 
parameters as described in the appendix. When In voked,, mod ule 1Qr214 accesses the c aflconf fite 1 0^16. 
reads it, verifies |t(i.^&the\s^ j^t>packages are jnstalted and nwdrflesnth^ af^icabte configUratfon 

^Rfj^l^fS^e^^ fecilitv;; in 
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Cluster client subcomponent 10-3b0a. The netacl.daen>oo 1CNa2p and netcall rrwdulo 1(K32K) make up the 
cluster server sutx^mponerit IQ-gpCWb. The call^ mc^ modulo. 10-312 perf6m> the 

same functions as described in connection .wtth s^m action component 10-200. The netact module 10- 
320 when invoked by eflher^^ ^ response to receipt . of command arguments, 

contacts the duster server system subcomponwt:.l!^30pb via the operating system network facilities and 
sends the command arguments to netacld daemon 1(><^. The daemon 10-320 In turn caHs netcall module 
10-320 which sends out a csUlptit focprd to ttW response center 16 via callput modide ,10-220 in the case of 
caHforce module 10-312 or through the callout manager in the case of cdlact module 10-312. 

^5 CAIXBACK COMPONENT 1Q-4O0 RGURE 4d 
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Rgure 4d shows In greater detail, the mirroring subcomponent, 1(W02 and permisston control sutxwm- 
ponent 10-422 of callback component 10-400. As shown, subcomponent 10-402 includes a remote account 
module 10-403, j^OTmniand fo^^ options >{ponfmon). nf>odiule 10-404, a monitoring 

configuration lite, :ipr405, a caDsatpt module. 10^. a piD file lO-^by. an interaeive session monitoring fite 
10-408, a sesston.log fiie(s) IcMpO, a Isles module a rrntees mpdul«> 10-411, a. showlses rnodule 

^ ^"^T^ '^f^^V!? ^^'t^^? ^ ^*^lfW?^f^ modules and ,files.we 

operalwely OJupii^ as shjbwn in Rgure^ 4d, Tlie -pmrae^ i^ recetve the 

remote' toglri from tf^ r4,,vla mt^em iZ,!^^^ fa repBi>«d 5^^^^ system :10r2 in 

a conventional manner through ihe remote togin facilities cA UNIX based system. iio4, However, the .profile 
mpcfcjie 10^ rausos th^^ a predetermined manner under control of 

caUback^cnnipoi^^ v-.,,,v'^ifv^ ^;;vr-;.,v.>^-; ■ ■^.v,; 

The confmon module 10^404 aflows ttie configuralton of the callback monitoring sesskm by mirroring 
subcomponent 10-402. Tlie confmon module 10-404 is Invoked in fMponse- to :a:'confmon commarxJ w^^^ 
the command Bne parameters descnl)ed in the appendix. When invoked. nu>dute 10-404 reads the eidstin^ 
*^'^?9V^?^;*^.'^^^.?^S9S^^ fiie,1<M05, p?roqasses , the com parameters, performs any 

nece^^ary chfK^ , . 

t*ifo caJIscripl nriiidute' ICHIC |tbe,.requii^^ necessary ,to cany out the scripting 

operations^ in response to a cai!^f)t;,cornmf^ ymh ttw .'ro^^ Dne parameters described.^.ln the 

^PI^S »^P>?^^ appropriate ^fi^^^^^ into which data from modem 12 is 
to t?® yjfritten. then se^ 0j9 twmini mode^ and rputes:the data Into the designated files (i<e., 10-408, ;10^ 
409). .>»^dftiona!ly, the mpdute 10:4^ aliw acq^^ recorcfirig the process 

ID of the djild procera K aeajos %^ out tho,op^ specified.by the command ;Hne parameters. The 
child process aips poerfo!^ fHes opened by the . parent process not 

needed by thecNId prooasb.. j.', ..." , .... : . ^ 

The showscript module. i 0-41 4 ofjera administrator console 10-14. The module 10-414 

aikirws display or playback' of the moriltorlng output capUired by caHscrlpt modute 10-404 and stored in one 
or more of the files 10-408 and 10-409 during a scripting session. The module 10-4^ is invoked in 
response to a showscript command with the conunarid Ene parameters described in the appendix. The 
command may be initiated by GMIS unit 10-6 through showtses module 10-412 and showses module 10- 
413 as indicated in Rgure 4d. When invoked, module 10-414 reads the files-created by callscript module 




Inyoked;^shows6srd@du1e>^ 




session log files 10-409 and lists the logged sessions using the facilities of system l64. 

TTie nhlses module ICMtl allows removal oif logged sessions, this nvjdule is invoked in response to a 
rmlses command which generates command fine parameters <Jescrit)ed in the appendix. When Invoked. 
nw)dule 10-411 pertorms peirmissioh and canmand argument checks and then accesses the directory of the 
to session log files 10-409 and removes the spedfi«J se^ori. 

The permission control subcomponent 10-422 Includes a doremoto module 10-424. a remote configura- 
tion (remote conf) file 10-426, a configure pennissidite (confperm) 10-428. a privUeged tasks 
function module 10-430 and nonprivileged tasks function module 10-432. The mbdules are operatively 
cormect as indicated in Figure 4d. 
»5 The doremote module 10-424 perfbnns operations for the -remote* user that require a certain level of 
permission. The module 10-424 Is invoked in response to a doremote command which generates command 
line parameters descrilaed In the appendix. When invoked, module i(M24 accesses rwKrfe config file 10- 
426 for determining if root access is allowed. When it is, the module spawms a root suijsfiea. 

The confperm module 10-428 allows the cohfigurafton of permissions to t» remote users 

20 who have logged onto the hbst system 1 0-2 through remote account module 1 0-40^ and operating under 
tt>e control of callback component 10^. This module Is invoked in respoKso to a c»h^wm cwnmahd with 
t»>e command line parameters described in the appiendix. When Invoked, module 10-^ it accesses the 
permissions configuration fHe fhroiigh acce^ rbuHne, not shown, similar fe^l^ above and 

reads the existing coofigurafion froifri file iO^. It tf^en processes the cc«imand 
25 the new configuration kito file 10-4a6J ^ ; . . , , 

The privileged tasks mbdulei 10-430 and the honprivileg^ tMte module 10-432 prw 
interface call parameteis to the operating system 10-4 required for frying put their rosfwtive 

RSF UNIT MENU SYSTEM - FIGURE 6 ^ * 

As discussed above, the RSF unit 10-10 utilizes the generid menu ihl^ac^ system (61^1^^^^ unit tO-8 
wWch provides a graphfe imeractwe screen brient^^ command interfacia. TOs int^ai»' ^'^^^^^^ 
embodiment uses a hierarchical screen organlzartton which indudes menu, setectc^ arkJ screen to 
generate the required command line parameters for casing RSF urirt 10-10 to perf<ii^ a spe^fic task, 

35 Figure 8 illustrates ttie relationships between the different menu, selector arid dialc^ '^awra uHflzed' b^^^^ 
10-10 accortfng to tite jwesent Invooiion. As Indicated, RSF iihit 10-10 Is acoessibl^ from tfie top level of 
the menu system whk* oonBsponds to a prbbtem ^etbrmincrttoh sutimenu. This submenu Includes four 
selection items correspoMing to message iwurces, messages, action^ arkl caltouVciib^ All four m€?iu 
items lead to submenus and all traversals ddwifi thrb^ menu slnicture ^wSially^^^i^ to diatogs for 

40 each RSF command associated with the menu selection. Therefore, ttie drffererit cornrnand fine operations 
described above In connection with Rgures 4a through 4d are normally canl^ CMit using this intefface. 

DESCRtPTION OF RSF CONFIGURATION PROCESS 

45 FIGURES 7a THROUGH 7f 
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5 as shown m Rgure Tb. TWs is carried out by seJecting tho ^Usl" button next loathe '^SOFmARE to IhstaU" ' f 

fieW. This causes the unit lO^ to (fisplay the soiactor menu of Rgure 8b; Moxt the user selects both the 
"obj" and 'data* parts for each subpackage which is to bo Installed. Such selecttons are made according to 
Figure 7b. After each subpackage setedfon is made, the user causes the dialog to be executed according 
to the Instructfons dispiayed on the menu screen. As indicated in Figure 7b. after complelfng the selectwn 

10 process of Wock 700, the user causes the dlatog to be executed whteh begins the Installation operation of 
block 702. During this operation, the host system 10-2 prompts the user for tbB disks to be swapped during 
the installalton. In the present example, the result is thai subpackages 10-100. 1(MO0 arid 10-200 Will be 
installed in host system 1 0-2, ' 

As indicated In Figure 7a, by way of example, the user performs the operartion of configuring a host 

fs system source such as ASCII source 10-102f of Figure 4a^ The sequence of operafions for configuring the 
source is shown in detail in Figure 7c. Referring to Rgure 7c, It Is seen firom Rgure 6 that the user selects 
the "message sources' submenu, from whteh can be run. four tasks, one of wfirch is labeled "add a 
source." The submenu can be selected directly through a fast path. For this submenu, the user types GMIS 
msg__8ources. This results in the display of the. first submenu of Figure 8c as in(ficaled by bbdc 710 of 

20 Flgure.7C. ■ .I., ./y , r 

, The u^r by selecting tt>e "add a source", menu Item causes the display of the dialog screen shown in 
rnenu#2,of.Figure.8c. ^ y- 

As indicated by blocks 712. ;714 and 716. the user enters informalibh such as the source Wentifier, 
source path name and the pamname of the actfon to be executed such as a oOlout^adBbn indk^ated as 

26 AisrAOn^fact Next, as lndk»tcwl/,by btock 7ia. the userienters tnforrnatlon specifying the source type as 
an ASCII source .whict} Is-indkated as v!»ASCn." ! A^ user spedfles me s6ure»'8 de^^ and 

searchtime. parameters, > t - ^^^^^-ri^'^w--: t 
^ Murce. me,user.alsp oeods to spodfy the f»ten1ial messages monitored • 

by the source l)elng afjio^^^ This can be done in two ways. One way H WpfejpeiitB^ iStiallStfon filb ahead 
30 of tin>o either, manually^of.^^^^ mkmsgfrnp program lO-IOOa In the rhaiv^^^ 

tfiavcase, the usw^^^^i^ only spedfy-; the JnitiaHzatiori^^^fi^ indteated bysWock 724 and -theh peffc^ I 

IndlMted daipg-. The b Figure 4a >iIIUcause ^theso messages to- b^ a to ttie 'niess^ 

tempteto dalat»se Jor the specified ASCII source 10Tl02f when the source is added:^^^^^ 

generates a command Une for the mkmsrc command wWi; the user supipOed inforrhatf^ Mkmsrc'program 
S6 . 10-1G6b CTuseS-tfie sowce to t^^^ by.establlshing the appropriate control rwbrd for the ASCn 

within control fOe 10-1 02b in the manner discussed. above. v\ -r. : i,-.:'^^^^^--^, ^:.:i:-v'i i > : , v 
^ Wi.^?^'9" fite has not b^en prepared ahead of tirhe. the user can add messages one at a time 

t>y .^odSrjg ttiej-add messages to message template , database" subrhehii. As'^fwwn in Figure e/this ' 

submenu Js dsplayed by selecting the "add messages to message templSe dafiba^^^ 
40 manages submeiiu .as Indfcated in btock 730. Selecting this rtem resutts in the display bf^^^a 

containing the WaiBfiers of all sources currently being monitored by BSF unit 1 6^10. The i^er 'selects the , 

source Wentiflor that was just added as imScated fri bkxdc 732. Once the desired soi^ is selected, the ' 

(flaIogs(^een el Rgure 8d is displayed by GMIS unHIO-B. r 

Next, as indicated In block 734, the user selects the regular expression value for the message which Is 
46 the parameter used to mateh messages read from ASCII tog fife 10-1 02f:-T^ user neirt fw^^ 

operatioiw of bkxfks 736 through 738 for selecting , the message threshoW, the duratton and kec^ax 

P?^^*?^ tor tfj^^^^^^ of a mkmsg oornmwkl Rrie by GMIS urilt'ioPa 

so ASat source as todk^ted by^t)lcx^ 
^e^user^^rei^.^^^ 

^g5ft!'S«r TS^fy ^^m^n^m&l^ the User^^fies ^ lhe?^sourc^^^f ^SYSltSr >Sr^g^ 
%||?^.S^^§PM^^ ^'^^^'^^ facilitates ^the >a^i #^^ftyj?^^f Tbirii^ 
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for die cluster dient system than those for configuring a cluster server or standalone system. The reason Is 
that the cluster seo/er or standalone system Includes a directly connected modem. Since tt» cluster client 
system performs tfie callout fwiction tfirough a duster server system over ttie LANWAN ttie user of a 
cluster client system does not have to configure all of Itie parameters which relate to such modem 
to connection. . • .. . ■ •••wwm 

Since tlw fwst system 10-2 is a standalone system, the user perfbims a "configure callout flocat 

I.^I^l::*'^ '^'^ R9"^ ^ «»y GM'S interface 
10« as Indicated in bkxk 753. The menu path is as indicated in Rgure 6. 

The submenu of Rgure 6e contains a set of selactiom that allocs a«tomizalion of the autodial function 
" t^T'!^- Pa^meters. modem parameters and cZt tuX 

Setecfing ^ site parameters" item of block 754 msults in ttie display of another submenu such as shown 

*^ ^ '^'^ ^ ^= this submenu contains further selections for manipulating local 
operator and system infbnnation. • ■ " 

VWj^n the user selects the "System Identifier" menu item of Rgura Bf, iMs causes >GMIS unit 10-8 to 
generate submenus requiring lurtlier user actions. The set system idenfiflef operation of blodc 758 is shown 

'"J?"™ ^^"'^ ^y^"™ «em off the disptayecl submenu. 

GMIS presents a dialog screen which asks the user to select what type of support denteK ixdtodbl wiM be 
u^ as indicated by blodc 75a 11*. allows the host systerh 10-^toSmunSw^S^;2pSI«^2nSl^ 
different geographical areas wWch may use different standard protocbi s&quen(ieste«)ciJdures for prbdSss- 
h^sopport c^ls, AS indicated by block 758-2. the user selects either "RC* or ■SC.-^,esutts'in me ^ 
performing the operations of either Mock 768-1 or .bkM* 758-a For 6l6dt 758^.^ the user only eiiters the 
^e'^!^ '^^^TTt^J^ Of Wock^ the user enlrirs several items of IriforJiatibn which 
are it^e srte ,^tiar,:tho inpdel. the serial number and a TAC character -all of y*i*' ha*e swrie specWc 

Jf'^ nefns. the user executes the dialog according to the insliudibhi^bnfthe niW to 
^wS »y«tem iderrtifter parameteh. ejfc. -«odute l^^^ 

758^ ). -njw causea^M.IS unit lOfl lo generate a calfcfg command. TTte calk^^cornmana 6'^^^ 

lr^6^r nSi^^l"^ '^'^ l«ramet«s dl«d by th«^ JrS am 

calkxjnflg. module 10-214 f* causlnjj the'^sioJage' of the user 

executed, both lead to Ihe operation of btock 780 of Rgure 7d « i^r.; -- ■ 

^ '^'^^ "^^^ Phone Numbers- menu item according to Uock 780; this results in the 
IS "^ f^^""^^ »9fl^ «0- ™s submenu aOows the user to Dst add *ir del^ rteponsa xienW 
SS^N'JZ^'Zf'*^: seleds the item ^a BRC 

KJJ^^' ^^V^^ ^"^ " each of the proper phone numbers as indicated 

mJ^ """^^ " f^"^ " "~ "^"«^ «« appropriate 

phone numb^ameten, based upon user seiecttons whid, are provided to the callcohSg modu(rir214 

forcausing storage of the user selected parameters In calteonfiglile 10-218 ; . 

of '^f™ repeats the operations of btedcs 764 and 766 until all 

of «»«^Prop^^. numbors have been entered. NextltheSuser returns to' die "site paramet^" subriie«u 



sy^em;qperatprv or^^^^ 



, ^. ,,„hP^,.!^ calfeut.^jttarnpt's^ TlS*o^^ 

« m«}$rgtm^^bef,et^,^fJ:M: 14. toxpntad'thjs^teca!'^^ 'op^fe affth&'fi^^ a'*^^ 

^'^'^^■mPSSm-iffhm ;fifeRSW^.'-Wheni the^kwiliadniW^&ataf^f*^^'^^ 
renk«e access.-this Hem-Is tefl blank; tt wra^ 
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passwd" conimand _ 

Infomwtion. As idasaibed , . , ,^ „ ^ v«..v.h ^.h.«..^« ww^^iu 

is wfilch are passed in the proper forms to callcohfig module 10*214 for causing the storage of such 

parameters In cattconfig trie 10-216. 

As indicated by Wock 776. the user backs out to the "configure caltout (Jocai modem)* menu of Rgiire 

8e. This Is done by sequencing back through the path (ndfcatod In menu system of FigWe 6. As Indicated 

by block 780, the user detenmines rf the modem b^ng used by host system 10-2 is the normal 
w preconfioured (default) modem connection. If it Is not the user selects the "modem parairwters" menu item 

of Figuve Be 0.e.. block 782). This causes GMIS unK 10^ to dteplay the subm^u of Rgiire ^ as Incficated 

by bkxsk 782. 

The user performs the sequence of of>eratfons of blocks 786 through 810 tor certifying that the correct 
modem comrnurtkiattori sWhg parameters are provided for configuring callbirt cornmunJcattons for both 
75 starKjone alorie and duster server, system corrfiguratio 

As shown, the user selects the "OK strings' menu Item on the display submenu of Rgwe % TWs 
causes QMIS unit 10-8 to disptay the sul3memj of Figure 8k as Indicated by Mode 7158. As seen from Figure 
6k, the user can fim, add or delete OK strings. OK sfiiiigs are the messages s^^ the nru>dem indicated 
the successful comp^tlpn of a modem icommand, A fist of nwdem OK stfng^ can be displayed by having 

29 the user selecting the "Dst' menu item of the submenu^brF^ Sk as Incficated fr> t)k>ck 7S0 of Rgi^ 7d. 

In response to Wock 790, GMIS unit 10^ dispfay^^^ cunrent oi OK strings virfthCK^ 

user dialog. As Imficated b^y btodk 792, if the user determine ttwt an OK string ne^^ lae added, the user 
then selects the "ADD OK string" item from the menu of figure TWs caijses GMiS unk 10-8 to &play 
the dialog screen of Figure ^81. ^ ' ::-l!.■^y^ ^ , 

25 Mext. the user enters the OK string wWch for nibk corresponds to itto default of "O" guid "OK" 

and presses the enter key. This causes GMIS unit lo-8 to ire(|uji%l:p^ 
dialog) as Micated tn blodc 7195. That is, this causes (^M to gc^^ corrvhand. 

The calkrfg comrnand is jprp^^ded with a corinmand Kto TOrnnwiid 
parameters whteh aiie {[passed the' proper ftim^ to mdSte^'lMi olsuch 

30 parameters in cdlconliglile 10-216. , ' y'''-"-'- ' 7''^ ' 1^'':",'^''';' ^' ^ 

If an OK string does not need to bo entOK^d; ttw user determines ^f an OK st^ to be cteletod as 
incficated by bkidc 796. if a siring is to be'i^leteidi tfie user a&lecte tfie *dele«9 O^^ sSiiig" itern on menu 
Figure 81 as Indiciied 'm btock 79?; This f»us^ Q^^^^ to'tfiat of 

Figure 81. This OK siring to deloje may^^ 
36 a string Is setoed by tfie user aintd tfie cfialoi)^^^ V carry ^out.tfie^ 

indkated in btock 798. GMIS wwt |P:8 wse^^^^^^ 

causes unit 1M to genenrte a c^^ command selected 
string and cornmi^ parameters: these f*^aiTOtera^£^ 
10-214 vrticii'access^ 

40 As Indicated In Figure 7d, the user t^^^ relsdive! to coring 

strings. Connect strings are the messages s»rit by a W 

connectkxi fias been established. The pperatipns off btocjbs 801 tfyou^h out In the s^e 

manna- as the list add and delete ojporations for the OK strings de^bcd itow. As shown In block 79a|» 
the user backs out toJ the "modem parameters" menu screen shovw) in iRgure eijVThis ^ 
45 the path Indicaled in Figure 6. . '\ 

As indteated in Figure 7d. this user, by selecting tfie "connect strings" mefUi Uem of f^ure causes 
GMIS unit 10-8 to display the submenu screen of Rgure iBou tf a connect string needs.to be acki^. the 
usSrSel&i^^f^ 
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t ^ing: W rc6rine<a:«^ 
S6 Connect String" meriu item.fmm, the submenu ^I^^S^t^^^ 
«^^the%I^^^^ 
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6 upon setecting the "other modem parameters" menu item on the menu screen of figure Si causes GMIS 
unit 10-8 to display the menu screen of Rgure Bo. As Indicated in Figure 7d. the user can enter several 
ottier modem parameters. 

As mustrated In figure Bo. these include selection ol modem network protocol (yos or no), a callback 
condition string which defines the modem callin conditioning string, a calkxjt condition string which defines 

10 the modem caikxil coodhlbning string, a dial siring whteh is the modem command string that is used to 
execute modem dialing operadon. a redo string wWch Is a modem comnwnd string used to execiite a 
modem dial repeat operation,, a disconnect string whteh Is a modem command string used to execute a 
modem disconnect operation, a hang-up string which is a modem command string used to execute a 
modem hang-up operatfen, a busy string which b a modem repiy string tor indicating when the dialed 

IS number is busy, character sire (bits) parameter defining the number of bits in a charactBr.(5n8), a stop bit 
parameter Indicating the number of stop bits in a character, a parity parameter for Incficaflng odd. even or 
no parity and a baud rate parameter defining the bauci rale of the modem. Upon completing the entering of 
the parameters, the user executes the dialog which causes GMIS unit 10-8 to execute the required 
procedure for adding the user entered modem f^amqlers. That is, GMIS unit 1M generates a caWcfg 

20 command containing a command line which includes the . other modem and command parameters. These 
parameters are passed In tt>e proper form to call config module, 10-214 which accesses conlig file io-2t6 
arKl stores the other modem para^^ 

The final menu item appearing in the -Configure Callout (Local Modem)" menu screen if Rgure 8e is 
"CalkMJt Tuning." The setecUon of this ineriu item causes GMIS unit lO-fl to display the cailoiit timing 

25 parameters meriu diaic)^ spw* .9f Figure 8u, Although not shown in Figure 7d, this sequence woukJ t>e 
represented similar to Ijfpck 776 and 782. A user via the screen of f^ure 8u can iRne tune several callout 
pararneters to satisfy t^ie ho^^ performance requirements. More spetaficany, the user can 

fine bw the foBowing palranrietars: a try coixTrtion parameter spedffying tfie number of retries when 
conditioning the rnodem, a retry for each number paranrotw Specifying tho^ mjm^t^^ of retries to be 
.^^ .7^9 phono number, a delay between t>usy retries parain^ sjwifying the delay 
''Qt'^i^ ®*^f*^,f**r ';o*^^ TAG phone number, a modem intercommawl^dolay parameter specifying 
the delay botwe^ itei^ sent to tAc 12, and a remote timewt parameter specifying the time-out 

period for w^ng'^ftw date TAC 1Z Upon oompMir^ ttw ^taring of the parameters, the user oKocutes 
the diakjg which cai^ GMIS unit 10-S to execute the procedure for adding the cilout tuning parameters 

55 to config fiie iCh2i 0^8^^^^^ 

As Indicated Ifi Figure 7d, the user na)ct performs tlie 'perfonn callout marjagement sequence" of Wock 
830. As indicated in fTgure 7d. ttife sequer^ro wpiijd be performed in the case where the host system 
modem is the same as the pfwwnflgured , modem as'incflcated b^^ block 780. Again, the user would backup 
to the configure caOpurt (local modem) menu by Wf^ng' the path Indicated In Hgure 6. The user, by 

40 sheeting thia •^caltout management" menu Item on ttie menu screen of Figure 8o. causes GMIS unit loil to 
present the menu screen of figure 8p. As seen from Rgure the user Is able to configure different 
callout manager opwatfng parameters as required for controlling the manner in which tfie calkjut manager 
processes Inconritng caltout requests received from the host system and any cluster clients. This is done bv • 
blocks 832 thfxwgh 839. ' 

4$ AS indicated when the user selects the "change/show callout manager status* item on the menu screen [ 
of Figure 8p. tWs causes GIWIIS unit 10-8 to display the dialog screen of Figure 8q. The user can enter the 

^ ^^^^ ' " ' 

^^^S^^TTntRlptef^^ /uieremennoine values in^ihe fields oT^^ 




^-JV?v?^pjr?.1^:?^ .6??^!P! f a routines of bloct, ,l%2lpc, stores^^^^^^^ 

selected callout mOT ' ' . ■ ^ ~, ... . , 

:$^^jJ^i^,^5t^JS?^to As 

shdwn: t^\^ cinm6^ to sSiSi^^ letSoot^'w miw a^ at'J^wt'S^^ 
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'ocedore 
i;atl. conynand 

6 tonal system coonmands to configure tX)ot time behavior. As shown^in Figure 76, this ends the. nlustr^tBd 
•calloul managemenr sequence. 

It will t)e appreciated that the user could make other ch^(^ or vtewr,the status p^ the calfoutrnanager 
module IO-264 t>y eelectino other parameter items on the memi screen of Rgure 8p. fir examplie. ttve "lisl 
Queued Cailouts" shows all of the cajlout requests stored in the caitout manager queue. The ''Show a 

10 Queued Calfpur Item allows an item from the queue to to slwwn IncliKfi^ when a 

queue index yalue is supplied. The 'Re^ye Queue Callout" item allows a calkxjt request to tie removed 
from the queue, the "Show Calloui Manager Stelus" Item allows the current callout manager conBguration 
and status to be displayed. The *Sta^^ Next CaJlout" itarn caus^, tt)e next callout request to start The 
"Restart Failed Qallouts" causes the .status of all failsd callout leque^ to to changed to "TWai^ The 

/6 -Display and Reset. Caflout Records" items ajlow the callout mari^rfs caBw witfiiri file 10- 

21C^ to be viewed and erased. // 

As indic^d in Figuie 7d. If at l>lock 750 t^ deterrnined ^^the host system was conngured to 
operate a truster cfrent system then the configure oeilout (clt^t^ diOTtj'se^ue^ 
858 would l>e performed. This Involves first selecting the "conflgtoe raBout (d 

20 indicated in Figure 6. ^te Inyojv^ the . •ponfigure c^^^ (du^^, ctent)vr^^ the 

calloutAcallbdck subn^nu, ITiis' ^c^^ pMiS ur?it i 0;^ tpldis^lay the jsub^ of. pigure 8s asJndU^ted in 
block 852. These oper^ttons aie carried, 0^^ as. that^de^i^^ in connection yi^ bk^ 

758 and 752- The user setects the "Syel^ ^^'^^^Tr ^'^^ ?^ fi^Ur®^l'*(W^ GMtS .unit to^ 

lo dispjay a dialog screern similar to jf^ure .^8(^ tto sy^ 

25 function of the type of support protoooi l>e!ng provided fi^.. "RC" or "SC*) and executes the dIaJpg <»using 
GMtS unit 10-9 to execute the ,prpo3dure.^.Thls^^ Oenerme a caJIcj^ cpmn^^ 

inducing the ,us;er , selected system MertifieH:-^£^ parameter These pararneters i are fi^ssed to 

calldg.modij^^^ ' \ ^. 

Iri tto cas^ rnenii item pnVlfie ocmfigure 

30 caJtout (duster dlerit) ifnenu iscreon of Figure 8i TTite submwi^^ 

system to make networt:,c^lo^^^^ r^uastejo tfie dufitor serwr systOT, r a diiecrtty connected 

modem, 7^ dOTe.ty sys^n.r^er t^ 

phon^, nMmbers. jr! r^^ionse. to ; sudi' se^ QMja urSf 1 0-8 ttie [^ic^ menu 5ii;een^ 1^^ 

8L M ijsho^OTi, tto u?^ syslein 

35 numijer, iwTKrte pa^^ ErWailaddires^ entering the.|^^ 

user^ exept^ caus^ QMlS ^uiiit IC^^to exea^^ stqrtog ■ t^^^ user^. select 

paranwlw^Ii|^c^^ ^ ^iy^'"^.. 

Fpiiqwing . eKKamfi^le, 
that the usiBf ^r)^,(^^ j|)fe csJlba^^^ estajU^^ how .caltto^ component 1 

40 Figure 4d is to prof^ cal^^ by TAG 12, Spedfi^^Hy^ Ws refers to how 

is performed in terms , irf configuring tfie .level or extent of t^AC ^ usef 'aixe^ altawed by permissions 
sut>component 10-422 and configurtng how TAG login sesstons fu;e to' to m mlrrorV»g, subcom- 

ponent 10-402. ■y--,^^' " ' . "," " 

Tto conflguratior* operation is shown In detail in ifiguros 7f and.7g. Rafening to Rgure 71. It Is seen In 

45 block 800 that the user selects the "configure caHback" menu item on the canout/calllijadc submenu screen 
which is accessed by the paih indk^ted in Figure 6. The user executes the dlak>g which causes^ QMIS unit 
10^ to display tfie submenu saeen, of Rgure 9a. As indteated .t^^^ 904^ the user, Wiects tN 

by -en&ifng either . v,,W..*,h 
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unit 10-6 ta tha'dialdg menu screian of i=lgufe 9c: 

In accordance wim Modes 920-2 through 920-24. the user enters the approprtato vaiues. The setection 
of the *s«assion notification Interactive" menu item enal)ies session notilication. This is used lp aiert the 
system operator In real time that the TAG has connected to the local host system 10-2. Usir^g this type of 
monitoring altoWs a local administrator to immediately log' the remote user off the host system by pressing 
10 the 'K" key while running showses module 10-413 of Rgure 4d the selection of the "Notificatioh DeVib^* 
menu item allows the user to specif/ the device bri which session notification will af^ar when sessfon 
notification Is erwbled. The seiecfioh of the session logging rrienu entry enables s^Ion fogging to be 
written into a session database filei (or ^^^^ The setectkwi of the EnaWo E-Mail Ofi caJMn; menu item 

enables etectronic mail rwtificaflon to tfw sys^^ dp^or that the TAG has connected to the local 
ts host system. The "E-Mail address" ifnehu Item Is used to specify where such notifibatii^ is lb be sent The 
Terminal Type for C^lback" menu rtem enables me user to specify the ternWnal type neosssary for making 
the TAG cal«>ad( to the ho^ ^V^^r As previously Indlcaited, this parameter requires the TAG to use the 
setecled terminal type to ensure that sudi caltoack s^ohs can be viewed on ^rmiiwi type as^ulable within 
host system 10-2." 

20 After aH the pararrieters haw beieri con^ the user executes the daiog to cause 6MIS unit 10-8 to 
execute the; procedure 1w sloii^ user selected rnbnrtoilng f^rametere/ Specifically, this causes QM1S 
unit 10-8 to genenate a j^ command containing a command irno which Irerfides the inonitoring and 
comifTiand paramete^^^ module 10-104 which stores ihe 

pairametere in moo contig fiio tO-405. This completes ttSe '<»nfigure m^ operatioo of t>lock *E of 

26 FlgiiroTi.''^ ■ .'-^^ v-''^- 

riexl, me us^ PC'rfO'Tns the configure cfiagnostic'op^raiion^^p^ F. This operation sequence aitoWs 
conngtffing me rsfd daernbn 10-110 oif Figure 4a (b i^^ ifte end-to^ cortt^^ betf^ 

the host system and the TAG. Ttiis dla^nc^ dahfigulrafi^^ to maIce:<»riNn ^ a caik>ul req^ 

Is made by daemon 10^100 when the sif}ecifled ^oeeds Itireshofd by peri<^k»ily irilecting system 

00 enrar log 10-1 62ewim a diagnostic riie^gaL > ■ ■ • r,- vr-^i^'-. r^^c^u^ 

This operatoi is shown In gre^ tfiat the 

operation involves eoceoutlon of bkxios 9^^^^ 

"actions" menu item on the remote iservicBa Ssimiw meW dbtaJne^^^ paih^jedfiecl in 

Rgure 6. This results In QMIS uniMO^ displayirig tifie ^ajfa^ Figiire loa^^ 
as •configiffe diagnosfic" menu item and «cbcute^ In re^ns^^^ 

displays* the dialog menu screen of Flgtiro' ipb5 As indlc^ ioS; me use^'^ers tfw ^i>r<i^iate 

parameters according to blocks 936 through 942 arx^ 

execute the prtK»duro for storing the iier c^ect^ Xhat is, 

GMIS unft 10^ geriera^ coriri^^ whjch'irxdudes^^^^^^ sefe^ted '*^^ 

40 These parameters In the proper form are passed by G^^S iinit iO-B to %^^^ 

Figure 4a. The program 10-106j utilizing me (»hfiguration' routines of RSF Rbrary' 10-104 enabf^ sto^ 

the specified paiaiheters wimin diagnostic configuration fite 1^^ 

Upon completing the operailions of Figure 7h. next the user performs the configure daemons operation 

of block G of Figure 7aL The bpeiatibn involves me execution of blocks 950 tfirough 962 as shown in Figure 
4S 7i. Inferring to Rgure 71. it is jseen that the user again selects the "actioris" menu itan on the remote 

services facilities menu. This results In GMIS unit m dispiaying the submenu of Rgure iOa. The user next 
RSF daemoh* menu item aikJ exeafes the diakw^ Thl^ cflmes GMIS unit 1 0-8 to disolav 

tSe!ffialSfn^^ 

so *thexii^^Thi^^i^ig^QMi&^i^^ 

■Spei^l^^ ^ "^ ' ■■ - 

afc^pSl^ria^ 

conff^ur^ boot timia behavior. 





20 



EP p Kt2 382A1 



6 completes tha configure daemon's operation of block Q of Figure 7a. At this < points* the user vnN have 
completed configuration of each of the RSF components of Rgure 3 precondltlonlrtg RSF unit 10-10 as 
desired. 

DESCRIPTION OF OPEBAHOW 

TO , 

Figures 11a through 13d lltustrate how certain ones .of the RSF components. of FigufB 3 operate as 
conRgured to carry ojut the remote support function. . 

Heferring fir^ to figures 11a through 11c, these figures are used to explain the operation of problem 
dete(^k>n and reactkKi componerxt lO^lOO of Figure 4a. This component operates under control of daemon 

7S 10-110. As discussed, rsfd daemon 10-110 detects problen» by scanning the system error log 10-I02e and 
ASCII file 10-102! in addition to any other configured source for specific messages and keei^ng count of 
how many messages of each kind it finds: and determining whether or not a message ;is overlhreshold. if a 
message is overthrcfshpkl, rsM daemon 10-110 etx 

As previously described, for each configured source, there Is a record stored In control file 10-1 02b 

20 containing assigned attributes, such as how often to s(^,the source for new messages, how often to dean 
Its datat>ase and.what action to execute if or>e,of,,the.mess3ges Jn. ttie source goes over threshold. Also, nsfd 
daernon^lO-llO maintains the message template database for esich source ccmtaining the search criteria for 
each rnessage, which It uses to scan lbr f^rticular messages artd to count ttie messages that are t>eing 
searched for on the source. Also. rsfd daemon ip?110 also perfonms diagnostic caltouts. As discussed, it 

2s can be configured to generate a callput action at/speci^c predefined .configured time intervals. These 
operations are. dUigrarriatically IHu^ In the simpOfj^ of tthe^^probtem detection and reaction 

cornponent..10-1(M:$hawn in Ftgt^^^ ^,5,,. ^.:,.>-..-r > o-.. '.^ 

Referring to Bgure^^llb, |t is. seen thatrfirst, rsfd daemor> 10-1 IQ , performs the setup operation of block 
1100. This operation Is shown in greater detail In Figure 11c As indicated by t>loc)cs 1100-2 and 1100-4, 

30 daemon 10^1 10 opens the source, attribute^ datat>asa J0*l02t) and begins reading each of the records from 
the database. , Eadi dj^tat^^ rea^d^ Is. re^ area of rnain meniory 10-3 as iindicated in 

block 1100-10 for txiih£ such ; records, The .daemon time 

parameter In each sudi record to scttedul^^a search event for tfie specified source asjndk:ated by bkx:k 
1 100-12. It uses tfw clean tbne^ paranneter ln each such record (p schedule a dean event for. the source as 

35 lndlcaled.by block IIOO-I^. - ■ : Zr ■ u k-- ■■■ ■••■•■■.v- -^v^^ .: 

The daemon 10^110 performs , the ^operations of^ W of the sources 

having records in the source attriMes database.; Ipr1,0a>. Upon completkm of tt^ operation, which is 
signalled by an erid of file IrKlk:atipri, daemon JOrl 10^ the diagnostic configuratkxii parameters 

from diagnostic conftguraUpn file 10-102g as Indicated by block 1100-6. As Indicated by bkcks 1100^ and 

40 1 100-8, whM the parameters indicate that the diagnostic feature has been enabled, daemon 10-110 uses 
the dtagnosfic frequency parameter to schedule a diagnostic event This completes the setup operation of 
block 1100. At this time, the daemon 10-110 will have scheduled all of the different events in an event 
queue which will control its operation from ttiat lime, 

F=ioltor^ setup, daemon 10-110 wil| enter a k)op wherein it win wait for the occurrence of the next 

45 event as jv^^ by dock 1102. When the event occurs, daemon 10-110 gets the event from the event 
queue and schedules the next occurrence of that event as irKficated by bkx^ks 1104 and 1106. Next, 
daemon 10-110, performs, a cfispatch operatk>n of^ bk)ck 1108 based on the type of event to one of the 
rcHitin^ 

. ^^;^i!^^ur^1^d^ 
jyixl^^Ki^^^ 

55 ^0^^^^^,^^^p«^^ b)^ %|^^^^2^(i,ei>^^^ ; 
ho^ systorn, tfier^ erf sea^ routiries. y>ne for; read{ng|i^ 

raiding ^stSm log fele io-iO^e: As i^^^ n^rdasfi)^^^ 
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by block 1108-14. In the case of System log file 10-ld2e. daemon l (VI 10 cahs the ID 'search routine 
which !ooks for error ID parameters In the source's message template database which match the error ID 
parameter contained in the record just read from the system log file as Indicated by block 1 1 0a-18. 

As indicated by block 1 108-18, when a match ts detected, daemon 10-110 updates the count parameter 
in the template database message for the message in which the match was found. Daemon 10-110 then 
checks for an overthreshoW concfitton as hdicated by btock 1108-22. This ts done by determining if the 
count in the temjslate database message exceeded the configuiBd count value previously obtained from 
source attribute control file lO-lOZb. When the count has been e)cceeded. daerrJon 10-110 executes the 
action configured for that partfcular source as indk»ted by btock 1108-^4. As' prbvtously discussed in the 
preferred embodiment, there are two supplied actions, a mall rwtificatk>n "action and a calkwt actiwi This 
results In daemon 10-110 InvoHng the mailact module 10-202. the callact module 10-218^10-312 of RoufB 3 
or whatever action has been selected. 

Foitowing that, daemon 10-110 continues on with reading messages. When there are no mere 
messages to be read from the source log file by an «id of file, daemon 10-110 returns to block 1114 of 
Figure lib. ■ ov ' ■ ■ . ■ ■ 

RguTBS 12a through 12c are used to IHustrate the operation of calltock component 10-400 illative to 
how the configured parameters as used to cohtirol ils operatton. Rgiiire 12a illustrates diagramallcally; the 
operational flow through the different configured subcornponents of callback o(imponent 10^ wh^n a 
remote user at TAG 14 dials into the host si^tem 10. As shown, the operating system kernel and drivers of 
bkx* 10-4 are utilized to altow the remote use^ called Vernote- to dial Ijacic into the host system -getty- 
daemon. TTie getty daemon will accept the cdnnectton to host system 10 and spawn a sheS for the user to 
ojn the remote user's profile ::file; In the pr^erit invention, the -profBe fili is a special .profile file 
corresponding to .profile module 10-403 which Is part of RSF unit 10-10. The .profile module 10-403 
performs certain functions pertaining to callback cbmfxineht 40-400 s^ 10- 

Rgure 12b illustrates the sequence of operaUons pertormed by .profile As indicated In 

block 1202. module 10-403 perfonns a setup operation and starts (^Jtecript-n^^ Also. profile 

module 10-403 includes means for trapping reihote user coritrbl signs^ s«tueiK^ used to gain 

control Of the host system. This operates as a sckjurlty mechanic k : = ' i 

Next, module 10-403 queries the mdnxm fite 10-405 via confrrKm nwdule^^ to read out set 

configuration parameters to dotemnine what lemriinal TYPE is to be used for caillii* as indfcated in btock 
1204. If the TYPE parameter has been set 4>rbfite nrk)duto iO^ Wilt s^ 

In memory to the configured value. If there is rio configured TYPE parameter, modillo 1<M03 will use the 
default value. This completes blocks 1208 and 1210, It then displays ^y desired proprietary message^fe g 
copyright notice) as indicated in Uock 1212 arid thin queries the mbn cont file 10^ via confrnon moiiOle 
10-404 to read out the configuration parameters for the E-MaH address to send notifteatidn of remote too-in 
and tog^xit operations as Indk:ated in block 1214. If an E-Mail address has been preconfigur^, modute 10- 
403 sends notification to tfie configured address, notifying that a remote user has togged onto host system 
as "remote" as indicated in btocks 1216 and 12ia ^ 

Next, as tndk:ated by block 1220. module 10^ queries the monxont file 10-405 via confmon module 
10-404 to read out tfie configuration parameters to determine whether or not any of ttio scripting options 
such as direct terminal, monitoring, interactive monitoring or sessioh togging have been enabled. If direct to 

terminal . monitAHnn < hae hoAn an aktA/i a^. . w <* f\sM/%fi n^„t» • '-n--^ - -i -i^ ■ ■ u ^ . . s' . ^ ■ ^ . u. .... . : ^ 



1226;mrtw^ 
be^^ehabledr;tf nonef* 

'^P^^^ii^ 'f^K . - ..... ...... ^„ „ , «;„p„ng opnoi.-,^ 
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requiring use of mc»dula 1CM30. It causes Ihe "crash" cocnrinand utilily of the host systern to be rur) against 
the host system's prtmary dump device. The cr^ cornmand requires "root" access and. therefore, is 
allowed or not allowed as a hihction of how permis^n sutjcomporteht 10-422 has t)een preconfigufeicJ yising 
the oonfperm command. 

70 The list overthreshold messages menu item when selected causes the generation of a Est message 
command (Isrnsg) with appropriate command line parameters! This causes Ismig c^ 10* 
I06f of Figure 4a to cause a display of a list of all the overtiireshold rne^»ges WkJ ttie te)d e^ 
message tht caused the overthreshoEd condition. - ^ i 

The root login meriu item is a privileged task requiring use of module 10-430. When setected, it Spawns 

TS a "super user" shell from which the "rernote" usdr can Hswia access to all host ^stom functions; Again, 
access to this menu item Is granted as a function of how permission sutJONnpbr^ 10-422 has t>een 
configi^ by the locd system administrator via the confperm comrnand. Tlite "user lo^" menu item a 
non-privileged task requiring use of module 10-432. VVhen selected, ari orcfinary user shell is spawned fi^om 
whk:h the "remote* user can have accede to user 'tK)st system fun^d^ 

20 The run GMIS menu item is a non-privtteged task requiring the use of rnodute 10-432. The sekKdtion of 
this menu item causes the GMtS unit math menu to t)e cii^layed to the "reniota" user and altows ordinary 
user access to aJi of *e function avaflat>le from 

When the rerriote iiser togs out, control ts returned to profile niodliile 10-403 which performs tfte 
operafions of t>iocks 1240 and 1242 tieforb ctosing. tl neieds to send e-Mai» ni^ficattori of the Ic^gc^ 

as Therefore, it queries the monxxJnf file 10-40^ via confiim module 10-404 to determine if jah E-Mail addr^s 
has been configured (i.e., block 1240): If it has. rhbduie 10-403 sends an E-MaJrnob'ficatlcm r^ to the 
configured address notifying the occurrence of the \oQoui {see block 1242^. It then will perfiorm the required 
cleanup opera&ons and ejdt 

While the remots user Is logged into host system 10, the remote user Is running the 6M1S unit 10-8. 

so From th[s unit, the user has the option of running several different tasks, some of which are non-privileged 
and somd of which are privileged. The system administrator on the host system is normally responsible tor 
saying whether or not the remote user is altowed to run these privileged tasks. The running of such tasks Is 
under the control of doremoto module 10-424 whk:h uses ttw configuration parameters stored ki r^ 
mote.conf file 10-426. Anytime tf>e remote user attempts to run one of tf^se privileged tasks, ttiis Invokes 

as doremoto module 10-424. This module runs as a setuid program on tfie UNIX based system which means 
that it is capable of obtaining super user privileges as it requires. Hence, it is able to bestow such privileges 
to run such privileged tasks. However, before carrying out such a task, it first examines ttw command line 
parameters to determine wtilch privileged task is requested. It then queries tiie remote.conf file 10-426 to 
determine if the task Is altowed. If it is not allowed, moduto 10-424 wi& print a permisston denied error, it 
is altowed, module 10-424 performs the task. TNs sequence of operations Is shown In btocks 1250 through 
1260 of Figure 12a 

Figures 13a titrough 13d as used to describe the hot key capability of callback component 10-400 
according to the present Inventton. Figure 13a dtagramaUcaUy illustrates the operational ftow o1 a twt key 
operatton which will be described in connection with the flow charts of Figures 13b ttirough 13d. In order to 
45 understand the hot key capability, it is helpful to understand how callscript module 10-406 operates. As 
prevtousty discussed, callscript module 10-406 performs all of the actual scripting of the sesston when a 
remote user togs Into host system 10. As lndk:ated In bkx^s 1300 through 1306, when callscfipt module 10- 
4O6'sterts'up,:ft:pfar505rits;cb^^ 

th^:^^.^^J3^Llf_^ 

50 then caJlscflpt module 10-405 writ^ me flp of the :sut>sbel! into PIQ file: 10-40^^. Asiihdk^^dd in bk^ 
1 308 thfx>(^ 1 340, It will :thV> dnter. a^rrialn Jopp wher^n it mi^s fronn itsy [n^ CNJtputei At 

the same itime, it checks to see if the sut>^II has exfled . When the subsholl oadte, cailsirfpt nrxxfUte 10^406 
performs cleanup arid exits. / 

While tiiese operations are taldng place, the tocal administrator upon receTving notificatipn of the 

55 occurrence of tfie remote user login may want to monitor the current sesston irritiated by tiie TAC. The 
adnninistrator does this by ninrilng -showses^ module 1 0-412 via terminal-lO-1 2 as tnidkis^ In Figure 1 3d. 
When invoked, showses module 1(M12 executes the sequence of operaltons shown in blocks 1350 ttirbugh 

1356-ol-Flguret-t3c:' - - - - . - _ ... 
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5 ShowscHpt module I (Ml 4 performs the sequence of operations indicated in Mocks 1360 through 1374 
of Rgure I3d. As shown, the modute parses Its command Bne arguments, reads from session file 1(M08 
arid writes to the local system administrator tenninai 10-12. While it is reading from session file 1(M08 and 
wftlng to tefmlnal 10-12. showscrlpt modute 10-414 also checks to see if anyone is typwng on the keys of 
local administrator console 10-^ 

to Because tile admJftistrator can hit a "hot key" to terminate the session, modulo 10^ checks to see if 
any key has been, sefected. If the "k" key has t>een selected, this signals shOYvscript module 10-414 thai it 
has to terminate the sesston. In so doing, module 10-408 first checks if the PID was specified on the 
command line which it would have t>een tjecause that is. how showses module 10-413 executes. That is, 
showses module 1(Mt3 is programmed to read the PID from file 10-407 and pass it to showscript module 

/6 10-414. Upon seeing that the PID is specified, module 10^14 sends a Tdlf signal to GM\S unit 10-8 as 
indicated in Figure 13a, If the key selected is not the "k" key but the "Q-.k^, module 1CM14 perfdrms 
cleanup operations and exits. By haying the nwdules of f=igure 13a operate in the descrit)ed manner, this 
provides the tocai administrator with a hot key capabiility thereby provkfing ttie fcjcal user with greater 
control over callback sessions. 

20 From the al>ove. it Is seen how the RSF components of the present Invention can be configured and In 
turn how such configuration infonnatlon controls the. operations of such cornponents. The organization of the 
RSF unit into such baste oorrippnents facilitates conflguratfon as well as expanstoo. According to the 
teachings of the present inwontion, each componem can be* configured with a small manageaWe set of 
comrnands. Also, new sources can be easily added or deleted and any action program can be easily 

2S specifted to perform any desired type Of support notification ^ 
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X. callaot Kodnle 



syntax: 

callacrt source_idcntif icr description_f ile 
message_identlfler 



Description 



Callact is a utility which executes an action (i.e., it 
may be configured as an action that is : taken by the: BSF 
ao unit when an over-threshold condition occurs) . The 
callact action sends a callout record to a response 
center location according to the parameters configured 
with the callcfg cojamand. 

25 If configured for a standalone host system %^ich has a 
modem attached, callact will use the callout meuiager 
module (see mkcall) to send a callout i record to a 
response center. In a clustered host enviroiimeht: (where 
there is one machine with a modem and several other lAK 

30 connected machines which share that modem- ^ ovisr the 
network) callact may redirect callout requests to the 
callout mzmag^r on a spTCi-|ied cimtxal np^^ 
modem \rtiich ik used, in turSr to cal^ reiifpdnse 'c 

35 The callout record that ii sent to the response center 
is created by callact and includes the following items: 

.Guiprenrt date^a tJjne^;;, . .. ; [ ' 
Site call out: configuration {phone numbers, system 
40 ID, etc) 

The text of the over threshold message: 
••descript4on_£ile** 

Information about the operating system (uname '-svr) 
Information about hardware configuration (Iscfg •v) 

Callact may also be configured to send mail to a given 
E-Mail address-.-whenev«fc^-a--callou^ j 
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15 



20 



Jhii utiii^ line or from 

GMIS. It is invoked by - risfd^ daeaoh process as ah 



action. 

"<^taons 



source^identifier Which monitored source is involved 

with this action. 

description^file File containing text of over- 
threshold message. 

message_identifier ID of the message that is over- 
threshold. 

Related Information: 

The folloving commands/programs: callcfg, callforce. 
netact, netactd, netcall, mJccall, Iscall, rmcall, 
chcall, calld, callout, callbin. 

2. oallhln Command IProgram 



Syntax: 



oo 



35 



40 



45 



60 



callbin -p primary-code -s secondary-code -f file 
"site^lnf ormation* y 

Description 

CalJi)in uses a modem to communicate with a response 
center to deliver RSF messages. This is a lower level 
program, not meant to be run from the coiraoand line or 
from GICCS, but which is caUed from the "callout" 
script*. 

The primary and secondary error codes provide the 
following high level information about the messaae beina 

sent.' '■.!■■-. --'^A^ /J ^ 

Primary Code secondary code Heahing 



OxOOOl 
0x0001 
0x0001 
0x0001 

0X0002 



0X0000 
0x0001 
0x0002 
0X0003 
0X0000 



Undetermined Error 
Hardware Error 
Software Error 
Operator Message 
Forced Callout 



This command program uses parameters configured with the 
callcfg command to control teieiihbne numbers dialed, the 
tty port of the modem used, modem control strings used. 
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jiL^ This c c arwand prpqran ret tes Its vrap por, wca^l^j^^||r^^ 



ts 
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35 



30 



to ensure that the modem is not in ,use by another 
application (such as ate, or cm) • 

The contents of tJi^ specl file; are sent to the 

response center as tHe :"free-fpra of the callout 

record, Theris is an imposed; 65 Kliot>ij^e maximum length 
for the data in this file. If the/file is larger, the 
message will be truncated. 

If "slte_infprmatlon'» is not provided, the local site 
information (as configured with, calicfg) will be sent in 
the callout record. The -s option is used to specify 
site Identifier information for IAN connected KSF 
"cluster clients"* 



Options 

-p primary-code 

8econdary'*cd<3e 
-f file 



Hexadecimal Primary 
(see above' table) 



Error Code 



Hexadecisial Seicondary Error Code 

;^|s|e|;'a^^ ■^'.^ ; ;■ ; 

ie^ile lapj^ifyi^ content ?of callout 
•S "site^infoxniia^ion^ "site identifier (from cluster 



clients). 



35 Related Information: 



The following commands/programs: .callcfg^ cssillact, 
callforce, netact, netactd, netcall, mJccall, Isqall, 
rmcall, chcall, calld, callout. 1 . t , : 
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callcfg [opphone»* phone number*] 
[ opnante» * operator name * ] 

[mail^'mail addr* ] [ ay sphpne«," phone nuaiber ■ ] 



to 



[passvd» 'password '3 [suptype«i*RC or SC»] 
^ - ' -»SC model'] 



[siteid^'SC site • ] (mbdelx 
[aerial«*SC serial #*] [tac='SC tac chaw:"] 
[ sys Id- *RC system ID •] 
[calltype«* modem or network^] 
[server** cluster server*] ttty»*tty path*] 
IS [cbits-'cliaracrtie^ bits*] [sbits=*stbpi bits*] 

[parity* *linift pcurity*] [baud»*baud rate*] 
[mnp«'yes or no?] ^ c 

(condout**callout conditioning string*] 
[condina*callbaclc conditioning string*] 
20 [dial««dial string*] 

[{add del} phone 'phone number <] 
[(add del} ok 'ok string"] 
[{add- dial} connec:t connect string* ] 
[ redo» * redo . string *, ] 
[ disconnect^ • disconnect string • ] 
[hangupff* I hangup, .strliwg? [busy* 'busy . string* ] 
[trypt^nen^retel^ phone number*] 

[tryconditibn^* reifies conditioning modem*] 
[ccmdelay"*ttodira delay*] 
[busydelay^* delay ^ 
^ [ remdelay* • remote laitency 'delay * ] 

[ remtineputB * remp^te time out,' } 
[ tracelevel- • 0-3:0 • i [ tracejcile-i * pathname » ] 
t-s] [-m] [-tj [-a] 

35 Description 

The callcfg command is used to set and display all of 
the parameters relating to the autodial function 
including those used on cluster clients. The various 
40 options are explained below. There are GMIS menus for 
this command. Use the GMIS fastpath ""brc^callout** for 
local modem configuration, or "brc^duster^callout** for 
cluster client configuration. " *" 

^ Options 

opphone* Sets the p hone number of the local system 

adSinistrator: ^"Tffii^ infoni^trion 

inc.lud^^^ callput records set to the 

■ ■■r^iisp)^^ 

ppnMe« Haine^- of^^^^^^t^ 




passwd^ 



T5 



suptype» 



sysid" 



model" 



serial" 



tac= 
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^smiiiP^^ be posted. 

Ko E- Kail will be sent if this parameter 
is set to (the empty string) . 

Sets the published passv6fi2 of the "remote" 
account as it is sjani: tb ' the response 
center in a callout recbrdi; Setting this 
P?^^®^*^ DOES KOT actually set the login 
P^sswoxSi oh "remote";' Setting the login 
password is a separate opieration. This 
paraunetet is optional, but should be set to 
the real password 6f "reabte" if call-back 
suppozrt is desired and should ba changed to 
the current password whenever the password 
of "rett€^te" is ch^ 

This parameter sets the type of response 
center p^ that will be called when a 

callout cx:cnirs. Set this parameter to "RC" 
for RC resjpon centers or, "SC" for SC 
response centS^^ If set; to RC, the' 

"sysid^* paramel^ set. If set 

to SC, the fbilbwirKgr parameters must also 
bej^|St . si|^ld, ..apdel,^..s;erial^ tac^.;,, v-/.;.^ 

TPhis paraa^ibr sets the system identifier 
for ^Is system. This parameter is required 
billy tpr xi^e vith RC respond, centers. 

This parameter sets the site identifier for 
this system, ^ ; t^ is required 

oiily for use witlj SC response centers . 

This parameter sete^^t^^ model name of this 

systM.^^^^^^^^^ ,T^^ is required only 

for use id,th, SC,.,re^ centers. 

This parameter sets the serial number of 
this system* This parameter is required 
only f or iise with SC response centers. 

This parameter. ^ sets. the Technical 
Assistance Center (TAC) ID of the 
responsible TAC, This y paramete r is„„ 



required only for use with SC response 

' ;Mt<^ial wi;t&^::'a^ Hp^: 
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sorver=« 



tty« 



disconnects hangup^ bxxsy^ tryphone, 
trycpndition, , i comdelay, busydelay, 
remdelay, remtimeout, tracelevel, and 
tracerile, BRC phone nunberXs), OK strings 
ana conriect strings. If set to "networlc" 
then., .this nachine is assuned to be a 
cluster clieiit which, laclcing a modem of 
its own, mus:t use a , cluster server to 
perform the bailout. If "riejtwork* callout 
is cpnfigxired then the «?server" callcfg 
parauineter must also l>e set. 

This peurameter sets .the hostname of the 
cluster server machine. Tliis parameter is 
required only when calltype»nettfor)c. 

This parameter sets the ,T*Y device (e.g. 
/dev/ttyl) that wili: be for callout 

and call-baekv Th for this device 

must have a modem attached and should be 
configured as i ; shared line if call-bac)c 
support is ^esir^^ 

This parami^ter sets the phone number that 
may be used to caLll b^c3c , to this system. 
Tjfiis is the phbne n the modem 

attached to the port ks^ociated with the 
device specified with "tty^". ' 

Thi$ parameter sets the number of bits (5- 
8) per cOiaracter that: aire used when 
communicating' with the response center. 

This parameter sets the nuanber of stop-bits 
(1/2) thait: are niseci when cojimunicating with 

the'res{k3nse'''cen1:^ " ''^ ' 

This parameter sets the parity settlhg 
(none, even, odd) that is \ised when 
communicating with the response center. 

This parameter sets the baud rate (e.g. 
1200, 2400, 4800, 9600) that is Used when 

es»sw^^ 

Thls_i>ir^^ not; the 

' " ■^^^'.'Q^^H^^y network 



sysphone^ 



cbits?* 



sbits" 



parity^ 



baud" 
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condin« 



Th is s etg 



string that is used vhcui' cbnditiotidlxig tfie 
modem for callout* 

This parameter sete the moden conditioning 
string that is use<^ aft'er^ a callout to make 
the modem ready to accept calls back. 

This parameter sets the modem control 
string that yill be usecl to dial out* 



30 



{add I del) phone > phone number' This syn'tax is used to 
add or delete phone numbers from the list 
of response center phone nuabers. During a 
callout these "^n^^ Be tried in 

sequence until a jsucceissful connection is 
made, 

{add I del) oX »ok string* This syntjik is used to add 
or delete strings from the list: of possible 
"OK** strings that may be rel^urned by the 
modem. 

{add I del) connect 'connect string* l^is syntax is 
used to add or delete strings 'fr tii^ list 
of possible **cohhectiSn ^ite^^ 
that may'be returned ^y the niNdSdem. 

redo<* This parameter sets the ^ckiieim " cohtrbl 

string that vlU be used to retry the dial 
out ' commiuid in ' 'the ev^enti bf'^r-a failed 
connection. If the modem being used' ^does 
not support a redo command then set this 
parameter to (the esq^y string) • In this 
case the entire dial out command vlll be 
re^seht to the modem on a rStry. • ^ ' v \ v 

disconnect^* This parameter sets the modem control 
string that will be used to end a modem 
connection. 



hangup" 



busy*" 



60 



This parameter sets the modem control 
string that will be used to hang up after 
ending a modem connection. 

This parameter sqpecJ^f ie^^'^:^^ iwhat^^^'stiriniSito ' 
eiqpfest : f mo^dem if the dialed^^ 
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trycondX13.on= This parauner^ sets how b 



_ . Bumy times to retry 

cdziditldning the jnpdea if modem 
conditioning shoiild happen to fail. 

71^.8 par^ the number of seconds 

to pause before sending coDin4nds to the 
modem. 

This p2urameter sets the niunber of seconds 
to wait between retries msJdng a connection 
if the connection failed because the phone 
was busy. 

niis paraiaeter sets the nimber of seconds 
to wait before sending data to the response 
center. 

This parameter sets the number of seconds 
to wait for data from the response center 
before giving up. 



2S 



comdelays 



busydelay» 



remdelay» 



remtimeout» 



Example 



00 



To set the local system administrator • & name to "John 
Smith", add a .phbne nurabe^^^ to the , list ^ of response 
center phone nuonben change the delay between retries 
on each phone number to 1 minute, and then display the 
complete, ranfiguratipm 



callcfg ; opname-'VJchn 
busydelay^60 -a 

Files .■■■■I 



Smith" add phone 5553421 
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/var/call/caai.conf A binary file which stores the 
configuuration mamaged by this command. 

Related Information: 

The following commwds/programs : calla'ct, calif orce, 
netact, netactd, netcall, nkcall, iscail^ rmcall, 
chcall» calld, callout, callbin. 
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- 'gnd't:im lny -t y f:'^ < i a triri i^ '^ t^t ^^ ^itl inS ig^l^ 

a queue of callout requests. The queua^ is netnipiilated 
with tbe nJccall 'md innc^^ Recpiests c'ahd 

parajaetera are viewed with the Iscall command. 
Configuration parameters are set with the chcall 
command* . -A 

This daemon controls the timing of callout requests 
according to the parameters configured with chcall. 
Callout requests are serviced on a f Irst-come^f irst- 
serve basis. Hie calld daemon is started and stopped 
using the chcall command. 

A log of all callout requests executed by the callout 
manager daemon is )cept in /var/call/callout-logi 

Files - _ ^ 

/var/call/calls/call.ctrl A binary file \dilch stores the 

callout manager. queue and 
configuration pauraaeters. 

/var/call/callout . log Log file listing all . cal louts 

invoked;- b^ the-- callout 
management daemon and c: !^ . the 
results of each, , > 

Related Information: !^ 

The follcying. c^mmsmds/pi^ograms: callcfg, callact, 
calif orce, netact, netactd, netcall , mkcall , Iscall- 
rmcall, chcall, callout, ceaibin. 

5, oallfozce Commaiid Program 

Syntax: , 

callforce [-bj [-f file] 

Description 

Callforce sends a callout record to a response center 
according to the parameters configured with the callcfg 

■ '-comana-xul'.— — ■ — — ^^^..^^^ — , — .. — - : j ^'^ f .--..-.^ > ^ — .-^ 



'^^li^i^^ . Mm^^m^mf^dS^: ^;rf gr^xt^stlng:,^ ' 
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record, othervise a text editor } is invoiced (using the 
EDITOR, environment variable or '■vi" as a default) and 
the message to be sent may be entered , 

rf configured for a standalone host system which has a 
modem attached, calif orce will use the **callout'* progrsut 
to send a callout record to a response center. In a 
clustered environment (Where there is one machine with a 
modem , and several other LAK connected machines which 
share that modem over the network) callforce may 
'fi redirect callout requests to the cluster server 
configured with callcfg. 

The callout manager program is -bypassed for forced 
callouts« This implies a higher priority for forced 
20 callouts. 

The callout record that is sent to the response center 
is created by callforce and includes the following 
items: 

^ Current date and time ^ 

Site ceaiout configuration (phone niimbers^ system ID, 

etcv)> 

The message to be sent 

Information about the operating system (uname -svr) 
30 Information about hasrdware configuration (Iscfg -v) 

This utility is used from the command liiie. it is not 
available from GMIS. ^ ^ 

35 Options 

-b DO the callout in the background. 

-f file Ose the contents of the specified file as the 
^ message to send. 

Example 

To send the contents of a file to a response center 
^ callforce -f message, file 

Related-Information^- — 



60 ne^a(rt^^-v;;-ne ^ iJica^ ■• tnw^iali. 
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callout -p primary-code secondary-code -f file 
-S *fiite_;lnformation" (-bdr] 

70 Description 

This program is a wrapper for the "calibin* program 
vhich uses a modem to isend a message to a response 
center. This wrapper script manages the modem's tty 
js port. 

If the tty port is in use by another applitiation (such 
as ate or cu)^ callout will either wait lintil the line 
becomes free, or put itself in the background and wait 
20 for the line to become free, depending on the given 
arguments. 

While calibin is using the line the tty will be disabled 
and then reset to its previously configtxred state when 
25 calibin- is finished. 

This program is not meant ^tp be executed from the 
command line or from GMIS. It is ^cklled f rom the callout 
manager daemon (calld), the RSF daemon (rsfd) , and the 
netcall and callforce scripts. 

See calibin for information about the rp, --s, -fy and -S 

options.- 

Options 

-p primary-code Hexadecimal Priinary Error Code 



00 



35 



^ -s secondary-code Hexadecimal Secondary Error Code 

(see callhih) ' . . ^ 

-f file File specifying content of callout 

rfftcbrd (Sioi^ calibi^^ 



45 



-S "site^inf ormation" Sltck identifier (see calibin) 



Run callout^ in ^t'^'^^Skj^tamd 
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-r 



Files 



Rexaoye the file specified by -f 
when caLlbln is finished. 



/etc/locks/LCK. . • LocX files used to synchronize access 

to serial lines 

Related Information; 

The folloving commands/progrdiBs: callcfg, callact, 
callforce, netact, netactd, netcall, mlccall, Iscall, 
rmcall, chcall, calXd, callbln. 

7. oalXseript cottmand Progran 

Syntax: 

callscript [-c command] [-f file] [-t tty] 
[-^ session fiitie] 
[-1 ctrl_fiTeJ 

Description 

This command program is used to support the RSP call- 
back environment <• s remote session scr iptina/mirrorina 
features. mt y 



TRie sta n dard script conmand program allovs only a user 
shell to be s«-ipted. tRiisv command program allovs a 
command to be specified on the command line. When the 
specified command exits the scripting session coa^letes. 
If no c og rn a n d is given ^ callscript uses the current 
40 user's $SHEU>, or /bin/sh. 

The -f , -t, and -s options allow files/devices to be 
specified as destinations for scripted data. Each 
option represents a different Corm of scripting (see 
45 below) . Any of these options may be specified multiple 
times with different destinations (e.a. ceaiscriot -f 

xsmi^xMrn.^—^-^-^ 
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j-„ fil^ stahdAae^ ''gcrlptr' eoaunand ei^ 

Verbatln copy of all data sent to, 
received , from the user's tenainal 
including control codes and carriage 

returrvs*'; 

-t tty Mirrors the session on the terminal 

associated with the specified tty 
daviod^ The tty way ^ a real t€y (e-g. 
Vdev/ttyl") or a pseudo-tty (e-g* 
Vd«v/pts/4"), The specified tty will 
be put ; into "raw" mode for the diu^tlon 
of tte [mirroriiig and will bo put >ac)c: to^ 
its original state when the session is 
over. 

^ -s session^file Writes a iCile in a special fonaat that 
• includes tiilhg infornation. This kiiK} 
of file cati be played back like a mbvie: 
usjj^ the" "shqws'cri^^ cpmuand. The 
shdiratbript conmahd program c£m also 

^ used'^ 

oiit ; This results, . in . a regular script 

-1 ctrl_flle M ;^iS;^^b^^ is giy^'^^^ 
30 coitBiaLhd progxram being scripted! is 

wltten to the s{>€K3ified fi^^ 

Example''^ J ■ 

To script a curses cklS sessijon to a session file named 
"seaafioii"- -^-^^^-^ 

callscript -c smitty -s session, 
Related Information: 

The following commands/programs: confperm, doremote^ 
confmon, callscript > sbbwscript, showses, Islses, 
showlses, rmlses 

0« choall Command 
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The maxcalls para»feter sjpeclf led with the -m option sets 
an upper llalt on the length of the callout nanager 
queue. If the number of Itens in the queue reaches this 
number then no more callout requests may be enqueued 
35 until itens are taken off thfe queue iyy rmcall oi calld. 

The -n option vill cause the next callout request on the 
queue to be started* This is ndnaally used when the 
delay parameter is set to •Infinite? and manual 
40 intervention for callout request processihg is desired. 

The -r option will re-start calloiits that have failed, 
Hhen calld executes a callout request; and the "callout" 
command fails , the callout remains in the callout 
^ manager queue with a status of "F". These callouts may 
be tried again (presumably after the problem that caused 
failure has been rectified) by running 



Description 

The Risr callout manager controls the sequencing and 
timing of callouts to a response center. It manages a 
queue of callout requests. The queue is manipulated with 
the mJccall and rmcall commands. Requests and parameters 
are viewed with the Iscall coamxahd. The queue is 
serviced by the callout manager daemon (calld) . 

This command is used to configure parameters that are 
used by the callout manager daembn (calld) to control 
when callouts will be taJcen off of the callout manager 
queue and sent to a Bull Response C^ter. 

ThB delay specified with the -d option controls the time 
interval between sending callouts ^en there are 
multiple callouts in the queue. Tlkl^ delay keeps the 
modem from being "hogged" when therie are many callout 
requests that occur witliin a small i)eriod of time. The 
delay allows a remote service representative to log in 
(If CTnfigured) . If the delay is set to "Infinite" then 
the - callout manager daembn will not start another 
callout until the -chcall -n" command is run. If the 
delay is set to "Hone" then calldia^ will always be 
started „the moment they are enqueued. Other valid 
delays are of the form { 1^9 99} -{hours | mins | sees}. 



•^ff used to start and ktb^^^^ ' 
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fastpath is -brc_calliaan». 
Options 

-d delay Set the delay betveen callouts 

-m maxcalls Set the inax^ length of the callout manager 

queue ^ 

Start the next callout 

Re-start failed callouts 
when Start the callout atanager daemon 
-X when Stop the caiiout iahag^ daemon 
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chcall 10-mins 
Files 

/var/call/calls/call.ctrl A binary file which stores the 

callout manager . queue and 
configuration parameters* 



20 



25 



Related Information; 

The following conaaands/progr ams : callcfg, callact, 
callforce, netact, netactd, netcall, nkcall, Iscall! 
rmcall, calld^ csallout. callbin. 

9* olmsg Conauuid 

Syntax: 

chmsg -n sfource_identifier -I message_ldentifier 
((-i nevid | -e expression)] (-t threshold] 
[•-d duration] keepmax] [-rj 

Description 

The chnsg command is used to modify the attributes of a 
monitored message in the RSP unit. The identifier of the 
message and the identifier of the source to which it 
belongs are required options. The following attributes 
of the message cem be changed with this cGsmand: 

^ message id This is the hexadecimal identifier used by 
the RSF unit to differentiate between 
messages. 

expression This is the regular expression used for 
4o pattern matching log messages. For example. 

consider the following fictional log 
messages ; 

BUS ERROR: CX}HTROLLER NUMBER 5 
BUS ERROR: CONTROIXER NUMBER 6 

Although these two messages are not 
?yS^itij=«41y- ide^^ are both 

■^j^rt^irigva The 

^messag^V'tog^^ '■ ■ 
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"BUS ERROR; CONTROLX^Zt NOMBER 

threshold This is the integer ntxnber of a given 
message vhich the KSF unit vast record 
before it will perfoza an action. When the 
threshold has been reached, the next message 
of that type will result in an action. 

duration This is the tiioe period during vhich a given 
threshold most be exceeded to result in an 
action. For exan^le, the RSF unit nay be 
configured to perform an action if message x 
is detected n times during time duration t« 
The duration must be specified as follows: 

{ 0-999) -{days j hours | mins) 

Keepmax This will specify the maximum number of the 
given message that will be stored by the RSF 
unit . This will eliminate the posslbil lt:y 
of runaway,, error messages creating a runaway 

RSF database,;;'".., ---^-/-^ ^ V:'.... 
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Options , 
-n 5ource_identif ier 

-I message_identi£ier 



specifies the 
the source. 

Specifies the 
the message. 



identifier of 



identifier df 



-I newjmessage_identifier Specifies the new id 

" . . .:■ ^^messageV 



for the 



*e expression 



-t threshold 



-d dxiration 



Specifies the new regular expression for 
the message. 

Specifies the new threshold value for the 
message. 

Specifies the new duration value for the 
message. 



60 



-r 



, the new Xe^pmax value 

.,i(ieeeM»^,^^ 

Resets ::^e me^ count to zero. 



^for jthe 



to 



I 

t 

j 
i 

I 

I 

I 
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nave a threahola 25 and a duration or 
chmsg -n testsource -I FFFFFFFF -t 25 -d 
Related Xnfonnatiion: 

The following coaaaands/programs: chrsf, chnarc, rsfd 
iMsg, IsBisrc, mkasg, mJonsrc, namsg, rmasrc, netact! 
netactd. 
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Syntax: 

chjasrc -n source_identifler [-1 nev source identifier] 
C-t type] f^p path] [-a action] C-c"cleantliae] 
[-S searchtime] [-f initialization fUe] r-bl 
[-U] [-e] (-r] " , ^ V 

Description 

The dansrc conimand is used to modify the attributes of a 
ttonitored source In the RSF unit. The Identifier of the 
»??i?H^^« '''"'f ""t^ ^ required option. The folloving 
attributes of the source can be changed with this 
command: 



source identifier 



type 



path 
action 

cieantime 



This is the ASCII identifier 
specified by the user for the 
SLonitored source. 

This is the type of the source. It 
can be either ASCII or SYSTEM, A 
SYSTEM source is the system log and 
an ASCII source can be any log file 
in ASCII format. 

This is the path to the source, or 
log file, to be monitored. 

This is the path to the action 
which will be executed when the RSP 
unit detects that a message has 
gone over threshold. 
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searclitii&e This is tbe l:iae interval at vhich 

the source, or log file, is scanned 
for new messages , The f ollovlng 
fomat is required for the time 
Interval: 

(O-adSJ-Cdays | hoars | mins} 

This is a file which specifies a 
list of messages to ;be monitored by 
the RSF unit on the given source. 
An example of the required format 
is. given b<eloH for , both ASCXI and 
SYSTEK sources » Idnes beginning 
with I are connents t 



initialization file 



For an ASCII source: 



fexpression 
system^error • * 



threshold 
2 



duration 
l^day 
H-^ays 



1/ o_er ror_on_device • * 5 

Pbr a SYSTEM source; 



fid 

23e44f 
abcdef 

action blocking 
action log 
reset 
Options 

-n source identifier 



threshold 

2 

10 



duxration 

1- -day 

2 - hours 



keepmeuc 

50 

10 



keepmax 
50 

: lox 'y--^ ' 



The action associated with a source 
can be blocked from executing « 

The record of actions associated 
with a source can be erased. 



The count o f over 
messages can be reset. 



threshold 



Specifies the identifier of the 
source to be changed. 



-i new^source^identifier Specifies the new. Identifier 
^ ^ for the given source. 



Specifies the hew type bf soiurce. 
Specfif ies t^ new p4tJi to the source. 



EP 0 632 382 A1 



-d searchtlm^ Specifies the new searchtiime 

-f initlalization^file Specifies the path to the 

initialization file. 

•t» Blocks the action associated with this 

source. 

UnbloOcs the action associated with 
this source. 

Erases record of actions for this 
soured. 

"T Resets counts of over threshold 

messages for this source. 

Example 

To modify the source "testsource" to scan the log files 
every 5 minutes and erase the action log: 

chmsrc -n testsource r-o 5-mins -e 

Related Information: 

The following commands/programs: chrsf, chmsg, rsfd, 
Ismsg, Ismsrc, mlcmsg, mXmsrc, mnnsg, rmmsrc, netact, 
netactd. 
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chrsf (-S { now | reboot | both ) ) -x { now I reboot I 
both ) ) { ~a I now | reboot I both } | -n { now 
I reboot | both)} 

Description 

The chrsf command is used to start or stop the RSF 
daemon and the netactd daemon. The daemons can b6 
started or stopped in t2iree different ways: 

now perform startup/shutdown now« 

reboot perform startup/shutdown at reboot time. 

^ both perform startup/shutdown now and again at 

reboot time. . 

Options ; 
^ -s Starts thc^ RSF 

Stops the BSp da^s^ 
Starts the netactd daemon, 
-n Stops tAe M 

Example 

To start the RSF daemon at reboot time: 
chrsf -s riaboot 

To stop the netactd daemon now: 
chrsf '-n now 

To start the RSF daemon and the netactd daemon now: 
chrsf -s now -a now 
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Related Information: 



The foll pylng coanands/ programs; 
Ismsg, Hsmsrc, mkmsg, mtansrc. 
netactd. 



netact. 
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Syntax: 

confdiag [•s | -x ] [-t frequency] [-q] 
Description 

The l^F unit may be configured to test itself 

enabled, a diagnostic r^^lne wilf 
^k'^^'L- to be written to tKe systek log file 

The RSF unit is set to monitor the sys^ Sg flle^i^^ 
1^^^ perform a callout as sooR as it iJ 
detected by the RSF daemon. This feature allows thi 

a^S«?w^1f^^^^^^ ^^'^^^^ that the HSF St is 

detecting messages, if calidut:(i) not maS 

when this feature is enablU, this L the 
first diagnosis that the RSF unit is sickl 

Options 



-s 



-X 



Enables the diagnostic iessage injection. 

Disables the diagnostic message injection ♦ 

-t frequency Specifies the frequency of the diagnostic 
message iniection to be performed by the 
RSF daemon. valid settings ai:^ DAILY, 
WEEKLY, BIWEEKLY, MOMTHLY, and BUTONTHLY. 



^q 



Defaults 



Displays the current 
diagnostic feature. 



status of the 



If no options are provided, the default option is -q. 
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confdiag -s -t WEEKLY 
2. To disable the diagnostic featiire: 

confdiag -x , ; 
Related Infomation: 

The following comaands/progra&s: chrsf, chmsg, chnsrc, 
TB rsfd, lsinsg,lsmsrc, lakmsg, nnmsg^ rmmaro, netact, 
netactd. 



13. Qonfmoa Conaaad 



Syntax: 



confmon [-dj [-x] device] [-s] (-n] [-m device] ;[-e] 
[-f] I-a address] [-1] [-g] [-c Temfrype]! . ' 
C-DSAiax>] 

Descriptioxi ■■ {\;-:/^--\!^'. 

This conpnond i^ )ased\to configu^ tiie session scripting 
30 features Of the RSP caXi-back environment. With 

session scripting. , , enabled^ i all characters : sent, and 
received to/ from the r«note user's t^nainal is captured 
and echoed to one or more, destiMtions , depej^ on the 
cbhf Iguratipn . This caii bef usecl. by the . local system 
35 admihistntoir to vatch ev^J^^ 

the '.;x^ote... .user 'to.; preserye .:'iqfstemv seci^ are 
three forms 'ofVses^sion tct^ 

Direct-to-^I^inBL^ ' '''F^a ; '/^ 

With this fqrm of scriipting the,^ 
user logs in on the sysltem a specified 
immediately taken over and a mirror ' of the remote 
user's terminal is displayed. 

Session-Kotification-Interictive Scripting / 

w^ thif^form^Ql^ 

199« in on the host system, a warning message;, is 
sent ., tb;/:tihe:-;5r»citied;;; :,v:.-:r6hce'- waCTtd^-'Me 



.... . ... ^r^^V^^'^n^' ' 



'logs- in^'-^ph !hlpst'"'^t:W;"^ a'"i^in^^'"i^W]tii 

• sent ., to., :tihe':-';sF^clf led ;;;€eCT'inai. vl-v^piice'- waratd^- 'tfi^ 

. .yiw^a/ilmirrSr 
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With this form of scripting a file is created which 
contains a script of the remote user*s session« 
There will be one such file for each time the 
remote user logs in. These files are stored in 
/var/call/sessions and are named based bh the 
date/ time of tha login. These files may be listed, 
played back, and removed with the Islses, showlses, 
and rmlses conmands. 

All three of these scripting options may be turned on 
and off independently « 

The -d option turns on direct -to-terminal scripting, the 
-X option turns it off. The -t option configures the tty 
device to which the remote session should be copied. 

The -s option turns on session-notification- interactive 
scripting, the -n option turns it off. The option 
conf igures the tty device ! to %mich the warning eibout 
remote user login should be sent. 

The option turns on B-mail notification. With this 
enabled, an E-mail' message is sent to the address 
specified with -a whenever the remote user logs in and 
out * The -f option turns oft E-^all nbtliicati6n\! 

The -1 option turns on session *lo^ 

The , -c option is used to specify the terminal tVpe 
($TERM) that must be used for call-back. This jitaramet^^^ 
is important because scripted sessions may be yiewed 
only on a ten^iml J^^^ to the teihidnal 

being used by £he remote user. Usiirig this' parameter, 
the local system administrator configures, the type of 
terminal on which the adMiJiistrator jpila^ 
scripted sessions. The remote user is then forced to 
us)e a terminal or terminal ei^ulator that is equivalent 
to the configured tetmihal type, 

Kote: if Direct-to-Terminal scripting is enabled the -c 
option should be set to , the terminal type of the 
terminal attached to the specified tty port. 
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> Ir t y d evice tb - 
terminzil scriptilng 

'-s Enable session-no^iflcation*interactive 

scripting 

-n Disable sessioii*notlCication**int:eractive 

scripting 

device Specify the tty device to use for session- 
notification-interactive scripting 

-e *Tum on E-iaail notification 

-C Turn off K-xall notification 

*a address Specify tbe E-mail address to use for £*mail 
notification 

-'I Torn on session logging 

-g Turn off session logging 

-c TeraxType Specify the tenainal type that nust be used 
for callback 

-D • Display direct-to-teminal device, if 

. enablejl ■>±r u-- 

-S Display sess;ion-*notlf IcationT . 

device/' if.;. eiiabledT:^^^^ ^:• - ^ ^-^J^-'- 

35 -A Display E-*mail address » if ,E-maii 

notification is enabled 

-I. Display >i" if session logging is enabled, 

"M»vbfeherwise ^ 



Display the terminal type configured vith 
the -c" option '■'^.-.^ -'y-- 



-O Command to discover (used by GMZS) 

Extuaple 

To ^disable „diractrdto=;teraaiji^ 
notificatipn-^interacrt: ; 'scriptii^ on, t^^ 
ew^ E-mail tb: iiiser ^phdt^ syirtem i^iz^ 

, 60 reiipte ' ^user's ; ■ 'logiiyiogou^^ ■ : :"amd'.^ .set: ' ^the: •'■'■;Mllf ■ 



49 



G098498 







Piles 



IS 



20 



25 



30 



3S 



40 



/var/call/mon.conf A binary file which stores the 

session scripting configuration 
parameters. 

/var/call/sessions Directory where date*stasiped logged 

session files are ]cept« 

Related Infomation: 

The following coomands/prograns: confpem, doremote, 
confmon, callscript, showscrlpt, showses, Islses, 
shotflses, rmlses« 



14 . conf perm Comand 



Syntax: 

confperm (-r] (-n] 
Description 

This command allows the local system ildniihistrator of a 
system to control whether or not remote users will be 
granted' root access. This applies' ' to the "Crash 
Analysis" and »Root Logiti" items on the "Callback 
Administration** menu that is presented to remote users 
when they log in. v 

If the -r option is used then future requests for root 
access will be granted. If the -n option is used then 
future requests for root access will be denied. 

This command is available from within GMIS. The 
fastp>ath is ••conf^perm" . 

Options 

-r Allow futtire root access requests 

-n— -Deny-fHitUTO-robt-accesis-reqiiestS" — - — 
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Vvax/caii/t^^ A b lnairy fil e — v fe lc a i stbt^ 

permimiona configuration 
parameters. 

Related Infonoatlon: 

The following comnands/prograns: confpera, doremote, 
confmon, callscrlpt, shovscript, sbovses, Islses, 
showlses , noises • 



15. dor emote Conmand 

Syntax: 

doremote -r * " 

Description 

If root access Is allowed then a root stibrshell will be 
spawned. Otherwise an error message is printed and root 
access is not granted. 

The only valid option is -r and it must be supplied* 

This command is not meant' to bie ri^ from the command 
line. It is run firom the GMZS ^'Callback Administration'* 
menu that is presented to remote users when they . log in 
using the RSF call-back environment. 
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-r s Request root access 
Example 

To request root access: 
'0 doremote -r 
Files 



15 



/var/call/remote*conf A binary file which stores 

penaissions conflgxiration 
parameters* 

Related Information: 

20 The following conmanda/prograais: confpena, doremote, 
shSS;;, rSJeir'^*^' showacrlpt, showsea, IsIsWs; 

25 16, laoall coamand Program 

syntax: 

Iscall [-n #] [-a] [-N] Iscall ( -p | -O ) . . 

Description , m;.:: ,:-v 

S-in^^^*^^*^''"^. controls the sequencing and 

timing of callouts to a response center. it nanaaes a 
queue of callout requests. This qiieue say be aanWated 
using the Bkcall and rmcall cimoands.' The queue is 
^fTTi?^ X. process (calld). Parameters 

relating to this queue may be set with the chcall 
connand. 

Running Iscall with no arguments will show the list of 
qqeued callouts along with a header that describes each 
of the columns. See the following example. 
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Date 



Time Origin Condition 



I S 12/14/92 15:09:52 jonathan PSP DIJICMOSTIC MESSAGE 
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W Waiting fox: the calld daemon .^^^^.to^^ service this 
request. Reqdests. are serviced! on a tirst- 
come-f irst-serve baisls. 

S Started. The callout is in progress. 

F Failed. An eztrlier callout attempt;.)^ failed. 
Failed callout remain in the qiieue and nay be 
restarted with the "chcall ••r" cdBahahd. 

The date and tiae fields represent vhen a callout 
request vas queued with the mlccall comnand. iThe origin 
field shows the name of the syst-em that generat^ed the 
callout reguesi:. The condition f ield shows a short 
description of the reason for the callout request.' > 

If the * -n ;# option ; is , used ^ then ; iJif ormatiqn , will be, 
shown tor the callout with the. given r^equest ID; only* If 
the ~M option is used the the header ^ will ^ ^ be 
displayed. If the *a option is used then the contends of 
the callout record will be displayed. Use -n nxvl -a 
together to look at the callout record for a particular 

callout. ^ ' ■ '"-'^ 'T'!'.^'^-''^''^^^^^^ '" ■ 

If the ->c option is used then callout manager status 
will be shown as follows: ■ i-^:^ 

Delay: 4--mins 
CalXs: 0 

Max calls: 20 ^ 
Next Call: Immediate 

The following explains the meaning of each field: 

Delay The time interval that: should be allowed 

between sending callputs when there.,, are 
multiple callbiit^s in t^e^ del^y 
Sceeps the modem from being ' "hogged" when 
there are many callout requests that occur 
within a small period of time. The deiiy 
allows a remote user to log in (if 
configured) . A delay of "Infinite* means 
^cjilld„will_.noJ:_:^r1;_i!in^ 
the^ fchcall -^n* command is run. A delay of 
' .-"Npj^ :^iridix!aj^ t wiJIf^ 
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25 



SO 



Next Call 



queue. If there are this number of callouts 
^^^^S*^ i« queue/ Bteall will return an 

error if an attempt is mad^ to enoueue 
another one. 

Shows the amount of time before the callout 
daemon will start another callout. 
"Immediate" means the next callout to be 
enqueued with mJccall will start immediately. 
"On demand" means that calld will not start 
another callout until the "chcall -n" command 
is run. 

The -o option is used by GMIS as a "comxnand to 
20 dxscover". , 

This command is available from within the GMIS unit 
The fastpath is "brc_callman". 

Options 

-n f Show information about the callout with the 
specified callout ID (#) 

•a Show callout record content 

~K Do not show headers 

-c Show callout manager status information 
-O "Command to Discover" (used by CKIS) 
Example 

To show information about callout ID number 37 includina 
the callout record contents: 

Iscall -n 37 -a 
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5 ' ~ ' — • — '■ t&e '"C^IiSi€" ' i aa n ^ — ■ — — 

conflgrur 

Related information: 

10 The following comioands/programs: callcfg, callact, 
calif orce, netact, netactd, netcaXl, mkcall^ rmcall, 
cbcall, calld, callout, cailbin. 

'5 17. Islaas ConmaAd 



Syntax: 
20 Islses 

Description 

If , Session Logging is enabled (see confmon), when a 
2S remote user calls^^ file is created \i^ich 

contains a log W alX acHzivi^ties perforaed. There is one 
such , , log : f lie . , f qr> each time a remote service 
r^presen^ ^o,. tfte^^^^ These session 

files my! be listed comaand* The name of 

30 the log' file represents tEhe Id^^ time at which the 

call-back occxirred« For exiiiiple: 

w Indicates that a call-bacX occurred on December 18th 
1992 at 2:43:57 PM, 

This command is hot avail£Ut»le^^f^ within GMIS as an 
individual command, but is used by GKIS to build a list 
^ of logged sessions from which ^ a session to review : or 
delete may be picked. 

Related Information: 

^ The following commands/programs: confperm, doremote, 
confmon, callscript, shovscript« shovses, showlses, 

" " '^-^rmi-B-esT ~: — — ; ™ 



Ismsg [-n source_ideritifler) [ {-i | -e j --a) ] t-<i] 
t-o] C-N] t[-S] -I message^identifierj 

Description 

The lamsg command program is used to output the messages 
monitored by the RSF unit. There are several options 
provided for different output formats. Jf no options 
are provided^ the defaiat is to use -i for SYSTEM 
sources and -e for ASCII sources . 

Options 

-n source_identi£ier Specifies the identifier of the 

source to be listed. 

-i List the ID'S only. 

^st ID'S and" ejcptressibh^ 
with ■ ;JLSCfl , 

list tfie following information: 
expression (ASCII sbuzrce^ btilyy/ 1^, 
threshold, duration, and 
ke^pmax. ' ' ^ 

-<i In addition to what is displayed 

with -a, output the times tainp and 
full description of all messages 
■ with a-^tiht >'0..; ■ 

List only the over-threshold 

-''messages. ■■■'•'.Uii^-^-^-.. 

*N Suppress the headers/ 

""^ List output in GUIS ready format. 

-I message_identif ier List only the message with given 

id.' ■ ^ r. 
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5 

Isusg -a -o 
Files 

10 Related Information: 

The follovitig commancls/prograast chrsf; chBLsg, chnsrc, 
rsfd, Isosrc, nJcmsg, laJcnsrc, ramsg, xmnsvc, netact, 
netactd. ■ ■ " 



IS 



20 



30 
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19. Ismsrc Connand Programs 

Syntax; 

Ismsrc [-iaxrcpN] [-t type] ([-S] -n source_idcntifler] 
Description 

The Ismsrc command is used to output the sources 
monitored by the RS7 unit. There are several options 
provided for different output formats. 

optioi>s '*■/■' . '. ^ / 

-n aource^idehtifier Specif ieis the ideiitifier of the 

source to be listed.. 

■*i List source identifiers only » 

-a Full listing of source id^ritif ier/ 

type, clcumtime, searchtiine/" arid 
oyexthxeshpU 

•A List source identifier, action, and 

action-^blocked values. 

-r List record, of actions . 

*c List record of actions on behalf of 

cluster nodes. 

-p List source identifier and path. 
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s 

Example 

To give a full listing of all ASCII sources: 
Ismsrc -a -t ASCII 
Related Information: 

The following comaands/programs : chrsf, chatsg^ cbmsrc, 
rsfd, IsBsg, aknsg, ukasrc, rmmsg, nmssrc, netact, 
'5 netactd* 

20. aailaot JtST Action program 

Syntax 

nailact source^identif ier description_file 
nessage_identifier 

Description 

tiailact is an RSF action (i.e., it may be configured- as 
an action that is taken by RSF when an over-threshold 
condition occurs) • The aailact action sends E-mail to 
^ an address specified vitt; the callcfg coj&dljbu^ 

To use this action^ R5P is configured as though it vere 
to use a looa n nake callouts. Telephone 

numbers for the response center and other modem related 
35 parsuaeters are, Ignored, i£ ,t^^ is used. Only 

mall is SMit:... ■,: 

If the E*-Dail address specified is the address of a user 
on a remote machine^ be user to configure sendmail 
^ appropriately* 

The callout record that is sent via E-mail is created t>y 
callact and includes the following items: 

Subject line with originating system and short 
^ description 

Current date and time 

The text of the over threshold message: 
■ ^despripltipn^f lljBg^:^ . . ■ .i ; .y I; . : . : . v ^ . ^ . . ; 
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vlth this action* 

description_£iIe File containing text of over-threshold 

message • 

message^identif ier ID of the nessage that Is over- 
threshold. 

Related Xnfonnation: 

The following cosoaands/prograns ; callcf g, call force ^ 
netact, netactd, netcall, i&kcallj Iscall, mcall, 
chcally calld, callout, callhin. 



21* Akcall Comand 



Syntax: 

mXcall origin] [-^ description] (-f file] 

£-p pcode] [-B 0oode] [-S sl-te- information] 

Description 

The RSF callbut manager .controls the sequencing- and 
tiaing of callouts to a response center^ It manages a 
queue p£ calloot requests, this queue may be i viewed and 
manipulated using the Iscall and rmcall cononauids. The 
queue is serviced by a daemon process (calld) . 
Parameters relating to this queue may be viewed and set 
with the Iscall and chcall commands. 

The mkcall comaand queues a new callout request with the 
callout manager«^ The info ^f, 
-p, -Sf and r-S options is queued along with the request 
and is eventually passed to the *"c2J.lbin" command. ^e 
the ""callbin" command for more information on these 
options. 

The ^ argument is used to specify the origin of the 
callout (the hostname of the system that is the source 
of callout) . Tbis is used to identify the calling 
system in the case of several cluster clients on a LAN. 
I C :;thia vparameter^; 4ssvnot^suppMed^r^I0i^^ 
ca3:lact::;;fo^ - 

The. ' ; -ril, . . ■ ir^^ l^s^^^^^i^-r 'a ■ short;\gaM izhu 
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rea^pn for t±Le.^^aMwt^; . ; r T*f^ ah<^ ^iMh 

If -f is net supplied, mkcall will read frtna stdin- If 
-p or *s are not supplied, a defatUt of oxOOoo is used. 

This coamand is not aeant to be executed from the 
command line or from GHIS. it is called from the 
netcall and callact script programs. For callonts 
associated with the system error log the short 
description passed with -d is the "Error Description" 
inexd* 

Options 

-o origin Origin of callout (name of calling 

system) 

-d description Short description of the reason for 

the callout 

-f file Pile specifying content of callout 

record (see callbin) 

primary-code Hexadecimal Primary Error Code (see 

callbin) * 

*s secondary-code Hexadecimal Secondary Error code 

(see callbin) 

-S "site^lnfomation" Site identifier (see callbin) 

£3cample 
Files 

/var/call/calls/call^ctrl A binary file which stores 

the callout manager queue and 
40 configuration parameters. 

Related Informations 

The following commands/programs t callcfg, callact 
c^llforce, netact, netactd, netcall, Iscall, rmcall! 
chcall, calld, callout, callbin. 

■ s^t^^ '-^r'n^;' - ".. ^: '^r 
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rn source^identlf ier { { 



expression I 



Description 



The niaasg comDand adds a nev aessage to be ULonitored by 
the RSF unit for tlie given source. Tha identifier of 
the soiirce for \rtiich the message is aonitored is a 
required option and either the -e, -i, or -f options 
must be used. The --e and -i options are used for ualcing 
a single nessage and the -f option is used for batch 
message creation. 



Options 

-n so\xrce_identifier 

^e expression 

-i message^identifier 

^t threshold 

-d duration 

-k keepmax 

-f initialisation file 



Specifies the identifier of the 
source to be removed. 

Specifies the regular expression 
for the message (ASCII sources] . 

Specifies the message id . (SYSTEM 
sousrces) « 

Specifies the threshold value for 
the message. 

Specifies /^^^^ duxration valvie for 

Speic^ keepmax value for 

tb^l^^messiii^^ /;V"'V;" 

Specifies the initialization fU 
for batch message crcmtibh* The 
following is an exa]iq>le of the 
format for both ASCII and SYSTEH 
sources: , 



For an ASCII source: 

threshold duration 
2 m 1-day 



fexpression 
" sy stem_error_ • * * 

"i/o^error^on^devico.*" 5 4«^ays 

^^^^^^^^ -F^^ 



ild 

23e44f 
abcdef 



threshold 
2 

10 



duration 

1- ^y 

2 - hours 



keepmax 

50 

10 



keepmax 
50 

10^? 
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Is 5 1 durat:loh is 1-day and keepmax is 20. 
Example 

To malctt a new message for the ASCII source "testsource*: 
mknisg -n testsource *-e "controller number -t 10 
Related Infonaation: 

The following conmands/prograas t chraf, chmsg, chmsrc, 
rsfd, Ismsg, Isnsrc, ntoisrc, nnnsg, nnmsrc, netact^ 
netactd. 



23. mkmaro Ccstmand 



Syntax: 

mknsrc source^identifier -p path -a action 

t-t typej (-C cleantiote] [-s searchtlme] 
t-t Initlallzation^file] 

Description 

The ]B)qtsrc cosmand Is used to. define a new source to be 
monitored by the RSF unit* llie source la a file located 
on the systeit which Is either a system log file or an 
arbitrary ASCII log file generated by any application* 
The. ttkasrc command requires a user defined Identifier 
for the source, the paiti to the log file, and the path 
to the action to execute when an over^threshold 
condition occurs. 

Options 

-1 source^ldentlfler Specifies the Identifier of the 

source to be created^ 

-p path Specifies the path to the source. 

-a action Specifies the path to the action 

to execute %rhen an over-threshold 
condition occurs, 

— t type. i ;Spef^ 

-c cleantime 4 specifies^ the ^ i^^ at whtchr 





2S 



30 



-f initialization^flle Specifies an input file for 

initializing the messages 
associated with the new source. 
The following is an example of 
the format for: both ASCII and 
SYSTEM sources; 



# expression 
" syst ett_error_ . * 

••i/o_error_on^device.*f« 5 4 -days 

For a SYSTEM source: 



For an ASCII source: 

threshold duration 
2 1-day 



lid 

23e44f 
abcdef 

Defaults 



threshold duration 
2 1-day 
10 2-hours 



keepmax 

50 

10 



Jceepmax 

50 

10 



lin-^^ 5^^?^ not I>rovidjed,^t^^^ is 

ASCII, cl^t^ is 1-day an4 fi^ ifiVs^hogi^^^^ 
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mJottsrc -i testsource -p path to source -a path to action 
-t ASCII " — ; " ~ 
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Related Inforination: 

The £ollovin9 commands/program chrsf^ chnsg, chmsrc, 
rsfd, Ismsg, Issisrc, ndcmsg, . tmmsg, nunsrc. netact! 
netactd. 



24* netact Comaiand Prograa 



Syntax: 

netact hostname action source^identlf ier 

descriptlon^file message_identif ien [options] 

Description 



The netact command program contacts the netactd daemon 
on the server machine "hostname*" and requests tliat 
"action" be run on that machine. The rest of the 
options are arguments Jtp ,the remotei,,actiohv . The 
"descriptlpn^f ile"/ i^^ a local Jcile, which is 4:caM)orarily 
30 transferred to tEe resnota host. Tlie stan^rd and error 
output from the remote command is transferred back and 
written on standard output of netact program. Follovina 
"message_identtfier," a list of additional options may 
be specified. These will be passed to the remote action 
^ as is« 

The netactd daemon must be running on the remote host* 
This utility is not used from the command line or from 
GMXS, It is used in scripts iDte callact and calif orce. 

^ Options 

hostname The remote host to contact. 

action The pathname of the action on the 

^ remote host. 

source-identifier -Which - monitored ™soU — involved 

with this action, 

60 de^cription_file pil^; conta^^ bf over-threshold 

... -. ,, ...J. _:::■■.„_ ;messa'gei^j:-u":i" 
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Related Information: 

The following conaaands/prograss: callcfg, callact, 
callforce/ netactd, netcallv mXcall, Iscall^ rmcall, 
chcall, calld, callout, callbin. 



25* netaotd Cluster Daeoon 



syntax: 
Description 

Tlie netactd daeiaon services requests fronj the netact 
conanand pr iTxrp>:Oig ^^^^^ot^ lios^sV It is 

iioplei&^ted as an RPC server the^TC protocol • 
This daemon^ ;a^ the asscici^^t are used 

to implement the callout cius€er 

The daemon^ i^^ ^9t rim^^d thesciojo^^ line. It 

may be s^suHted ^stopplad.;^f w or f rom Jthe . command 

line vith the ciursf covmaiid. The fast patin for G^S is 
"actions". 

Related Information: 

The , follovlng commands/programs: chrsf , callcfg^ 
callact, calif orce, netact/ ^netcall, mkcall, Iscall, 
rmcall, chcall, calld, Ccallout/ callbln. 



26. neteall R8? Action Program 



Syntax: 

neteall source_identif ier description_f ile 

message_identifier host_name site_information 
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system — I n ci o hJU^ the r i^tik^ 



netactd programs to send a callout record to a response 
center from a cluster client system response center in a 
clustered callout environment. 

When a cluster client needs to make a callout to the 
response center, callact is invoked by rsfd on the 
client system. Callact determines that it needs to send 
the callout record to the cluster server system, so 
callact invokes netact with an action of netcall. 
Netcall passes the callout record to the callout manager 
(see nJccall) . Hetcall also handles remote callforce 
requests* 

The callout record that is sent to the response center 
is created by callact or callforce* Ketcall adds 
cluster server site configuration to the callout record 
before passing it to the callout manager (for normal rsf 
callouts) or directly to callout (for forced bailouts) . 
Ketcall may be configured to send mail to a giVckh E-Mail 
address whenever a remote callout request is made'. 

This utility program is not used, from the command line 
or from GMIS- It is me^ to :bitt invoked by netactd as 
an action on behalf of a remote call w request-' 

00 Options 

source^identifier %ich monitored source is involved 

with this action, 

35 dfescription_file File containing callout record 

generated by callact. * 

messaga_ldentif ier ID of the message that is over- 
threshold* 

40 

liost_name Network name of the host that is 

meOcing this request. 

slte_information Site identifier Infonoation from the 
4s cluster client. 

Rialatj?id^rnfprin^tion: „ _ 



1???— ^OllowiJig;^ ^ c callcfg, callact, 

c^llf prce, netart , ;n^ mkcall, iscall, rmcall. 
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'Syntax ^ 



nacall ID (ID ID 



10 Description 

The BSF callout manager controls the sequencing and 
timing of callouts to a response center. It aumages a 
queue of callout requests* : Requests are enqueued using 
the aOccall comi&and* Requests and parameters are viewed 
with the Iscall command. The queue is serviced by a 
daemon process (calld) • Paraneters relating to this 
queue may be set with the chcall consiand; Ibis command 
removes the. calibuts requested with .the specified 
request 70(5)* See the Iscall comaand for a definition 
20 of "request ID". Callouts that have already been 
started ('*S" status) may not be removed. 

This comaand is availaJt>le f xx>a within ' GICIS • The 
fastpath is "brc^callman". 

Options 

ID Request ID of the callout reque^l:' to ibe rdisGived 
Example 

TO remove callout requ^est ID htinber 25 ^ 
rmcall 25 
^ Files 



/var/call/calls/call • ctrl 

40 



A ; binary file which stores 
the callout manager queue and 
configuration parameters . 



Related Information: 

The following commands/programs: callcfg, callact, 
callforce, netact, netactd, netcall, mkcall, Iscall, 
chcall, calld« callout, callbin. 



2Sv raX-ses-C0«ttasi4 



60 



Syntajc: 



currently logged sessions aay be vleved using Islses. 

This cononand is available from vithin GKIS . The 
fastpatH is "call^non'*. 

Options 

logged^session The logged session to remove 
,5 Related Information: 

The following coxnntands/progrzuns: con^pens, dbremote, 
confaon, callscript, showscript, shovses, Islses, 
showlses. 
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29 • mnug Conaiand 
Syntax: 

nnmsg -n spurce^identif ier -i message^identifier 
Description 

The nnrasg coinmand is us^ to remove a monitored.. message 
from a monitored source. This is used to alert the RSF 
unit to no longer monitor the given message. 

Options 

-n source^ldentifier Specifies the identifier of the 

source for which the message 
belongs. 

-i message_identifier Specifies the message id to be 

removed from the given source. 
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nmnsg -n testisource --i FFFFFFFF 
Related Information: 

The folloving cosa&ands/prograBs: chrsf, chsisg, chmsrc, 
rsfd, Isosg, Ismsrc, nJdosg/ uknisfrc, rrmsxcj netact, 
netactd. 



30* mftsro CoBDBiaxid 



Syntax: 

nrnnsrc *n source_identlfier 
Description 

The nunsrc conmiand is used, to remove , the specified 
soiirce from the list of message sources dinonitored by the 
RSF unit • After this is done , the mKnsrc command Is 
used to restart monitoring of the sourcev i ^ 

Options-' 

-n source_identlfler Specifies the identifier of thW 
*~ source to be removed* 

Example 

TO remove a so\irce named "testsource": 
rmmsrc *n testsource 
Related Information: 

The folloving commands/progrzutus: chrsf, chmsg, chmsrc, 
rsfd,,. Ismsg, Ismsrc, mkmsg, mlgosrc, rmasg/ netaot, 
netactd. ^ 
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rsfd [ -t level [ -f trace^file ] j 
Description 

ms is toe RSF daemon. It can be started with an 
optional trace level between 0-^9 and also an optional 
tracing output file. The default Is no tracing. 

When rsfd prograa is started it performs a sanity check 
on the HSF configuration (see rsf stat) . Ahy wSSnff 
fatal errors are reported. If there are any fatal 
errors the daemon will not start. :/ t «x 

Options 

output^^ ^^vel specifies the detail of tracing 

-f trace_file trace_file specifies an output file for 
25 tracing output. 

Related Information: 

The following cowmands/prograais: chrsf, chnsg, chmsrc. 
Isasg, Ismsrc, nkmsg, mtaasrc, nnmsg, mmsrc, netact, 

32. rsfatat Coaraand Prograa 

synteuc: 
rsfstat [-V] 
Description 

The RSF unit Includes up to three daenons: calld 
netactd, and rsfd. This utility displays a tabl4 
showing the status of each daemon. if the daemon is 
running then the status is -up-. m this case, also 
shown are, how long the daemon has been running and what 

l^^J^^^m^M..^ If^the..daemon-„is™.not~^ru^l^»g-^then 
the status is -down-. t««n 

then only' .the 
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-V Perform sanity checic on RSr configuration « 

Defaults 

Bxaa^les 

Typical output from rsfstat looks like the following : 
Daemon Status 



rafd up (7-days, pid»X0895} 

calld down 
netactd down 

Related Xnfoxndatibn: 

The following connaands/programs : chrsf, chcall, rsfd, 
netactd, calld. 



aa. ahowXsas comud 



Syntax: ■ 
showlses logged^session 
Description 

This comuind is used to view a session log created i^en 
a reobte user ■■logs;^n '-tp/1±^ 'J^''/:, ^ 

If Session liogging is enabledi (see conteon) , , wbenv a 
remote user calls in to a system a file is ^^'c^ 
contains a log of all activities perfozned. There is 
one such log file for each .^im ,a rew 
repfeseiitative logs in^ t^ system*. These session 

files' nay be listed with the Islses cosxnand. ^ The Vname^ 
of the session log^ is passed tp shpwls^es. The name of: 
the log^ file riepres^mts date and tine at: which .the 

45 call--back ..opcuned. ,.^.'.For ,^2^ ]•:>; ,■:.*■. ^^^-^ 

BRC-12I8921443S7 

■Indlj^j^s^jtl^ ;Ca4J.Hb« occurr^^' . cn^' i>ece]Bber - ■ ISth- 
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~ p PiKhgea/restim efl vlwing ■ ■ '"^ — 

1 Speeds up viewing 

space Slows down viewing 

coBmand is available from within Oas . the 
fastpath is "call_jDon". 



10 



Options 

logged-session The, name of the logged session to 
,g iIism' * ^ logged sessions may be seen using 

Related Information: 



20 



30 



The following comjaands/prograns: confperm, doreaote, 
confmon, callscript, showscript, showses, Islses, 
ntlses. 



34. shovBcript covnand Trograa 



Syntax: 

showscript i-s j -r} script-file 
showscript -c script-file -p pid 

Description 



This connand program is used along with the callscript 

supporib the console logging and 

comnand reads files created using the -a option of 
IS^'i'^V ^5?^ ^^^s contain scripted sessions with 
information so that they can be played back like 
a ^ movie *■' ^ ^ '" ' ^' - ..^^ --.v,.,,- 

40 The terminal that session files are viewed on must l>e 
oquiTOlent to the kind of terminal that they are 
recorded on. In order to help ensure this/ session 
files^created by callscript contain tie 5TEm that was 
in effect irtien the script was created. is checked 

^ against the $TERM that is in effect when showscript i^ 
^ <lon«t match then a warning message is 



50 



•Ko|,e| 
names. ' may 



:*toTiyoi-times; teraiha^-^ types' have^^'i&ffereat^-'' 
ly^ ^liave. .' d^f initio endiig^^ 
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files. Bxe first f oru (using rs) .reviews a ccsnplete 
session file (see stvc>wlses) . Ktiexi tixe end of the file 
is reached showscript tenainates , The second form 
(using *c and *p) shows the contents of a session script 
that is still being created (i.e., callscript is still 
running) . When the end of the file is reached 
showscript will wait for more data to be added to the 
file (see shovses} . The process with the pid specified 
with the -p option is sent a SIGKILL signal when the 'k' 
••hot key^* is hit. 
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There are special keys that can be used while viewing a 
sessions 

q Quits showscript 

p Pauses/ resumes viewing 

I Speeds up viewing 

space Slows down viewing 

k Terminates process with pid (used only with - 

c and -p) 

Note: The 'k' key does not end the showscript vsession. 
Hit to stop viewing. 

RSF users do not invoke this command directly or through 
GMXS . This command is called from the showses and 
showlses scripts which are available through GMXS. 

Options 

-s script-file Plays back the specified script file 

-r script-file strips- timing information from the 
specified script file. The result is 
written to standard output c i.'. : 
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pid Specifies the process ID to lAich a 

SXGKXLL is sent If the 'k" "hot-key" is 
hit. 

Examples 

To view a previously recorded session, 
showscript -s script-file 

To strip timing inforaiation from a recorded session 
showscript -r script-file > output-file 
Related Information: 

The following commands/programs: confpera, doreaote, 
confmon, callscript, showscript, showses, Islses, 
showlses, nalses* 

35. sboirsaa Command 

Syntax: 
showses 



Description 

If Session-Kotification-lnteractive style session 
monitoring is enabled, (see conteon) when a remote user 
calls in to a system a warning message is displayed on a 
terminal chosen by the local administrator. The wamino 
message says ... 

Remote maintenance session in progress 
Type * showses* to monitor 

This command may then be used by the local administrator 
to view everything that the remote service 
representative is doing. I f the local adminis trator 
hits-iai®~n!r«— key, il: iaTI~iTO5aiately log the remote 
user of f the system. 
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with the remoto session. The *1* key 'may be used to 
speed up viewing. Other special keys are: 

q Quits shovses 

p Pauses/resumes viewing 

space Slovs do%m viewing (until caught up] 

This command is available from within GHIS . The 
fastpath is "call^mon". 

Related Information: 

The foil owing commands/programs : conf perm , doremote , 

confnon, callscript, showscript, showses, Islses^ 

showlses, rmlses. ' 
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A binary file managed by RSF unit 10-10 which 
records information about sources being monitored 
by RSF unit 10-10 including parameters that control 
10 liov each source should be monitored. 

ME88J10B TEHPUTBS DATABASE I 
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A binary file managed by unit lo-io which contains 
search criteria and status information for each 
message being monitored. There is an individual 
message templates datab€ise for each source beina 
monitored. ^ 



STOKED KBSiSXQB DATABA8S: 



A binary file managed by unit 10-10 sAich contains 
a recent history of messages being monitored which 
have appeared. There is an individual stored 
message database for each source being monitored. 



XBBFMAZ: 



For each message in the message templates database, 
the keepmax parameter sets an upper limit on how 
many of this particular message will be backlogaed 
in the stored message database. 



BOOBCB: 



A "source" is any source of messages (such as a log 
xxxej . 

MESSAGE: 

A "message" is a record that appears in a source. 
THRESHOLD: 

^ A "threshold" is a number of times that a 

particular message must be observed before that 
message is considered "over-threshold." 
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considered overthreshold if the Izhreshold is 
reached within the duration (e«g. 4 anist appear 
within 5 minutes to he over-threshold) • 



KCTIOK: 



An "action** is a program that is run in response to 
an overthreshold condition. Any program can be 
specified as an action. 



0SAKCKTIKE: 



For each source, this parameter controls how often 
unit 10*10 will scan the source for new messages « 

cz^aktxhe: 

For each soUrce, this parameter controls how often 
the associated stored message database is cleaned 
(old messages are removed) « 

8TANDXXOKBS 

A host system with modem connection. 

CLU0TBB CIiZEHTS 

A host system with no modem connection which uses a 
cluster server system to maXe callouts. 

CLDSTBR SBRVSR 8T8TBK: 

A host system with modem connection which is shared 
with cluster client systems. 



45 



Routines uysed to maintain the log of actions taken 
by the RSF unit. 

Remove (delete) the action log 
Add an entry to the action log 

2« Control Routines 

Routines used to access the source attributes 
database (control file) . 

Open the control file 

Read the next sequential record from the 
control file 

Move read pointer to the start of the control 
file 

Add a new record to the end of the control 
file 

Look up a control file record based on the 
source ID 

Change the contents of a specific control file 
record 

Delete a specific record from the control file 
Close the control file 

3. Config Routines 

Routines used to access the callout configuration 
(call. conf file) • 

Set default callout configuration parameters 
Read; the callout configuration from the 
call.conf file 

Write the callout configuration to the 
call.conf file 
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Generic routine to print format a message 
regardless of type 

Routine to print format an ASCII message 
to Routine to print format a system message 

5. Keep File Routines 

Routines used to access the stored message database 
IS (*.keep files) 

Delete an entire keep file 
Create a new keep file, 

Clean a keep file (removing logically deleted 
entries) 

Open a keep file 

Read the next sequential entry from the keep 
file ^ 
Move read pointer to the starl; of the keep 

file - •: V 

Add a new, entry rtp -toe end^ the: keep file 
Logically delete the last H kept messages with 

a :.^speqif ic -ID ■■■ ■■: . v. . - 

Logically all kept messages with;; a specif ic ID 
30 Adjust durations for kept messages with a 

specific ID 

Logically : delete expired messages with a 

E;pecif ic ID 

Cloase the keep file 

6. support; Routines 

Hiscellansous routines used by various RSF modules* 

40 Internal/User parameter forsiat conversion 

routines. 

User parameter format checking routines 
Initialization file parsing routines 
User access restriction routines 

45 : ■■ 
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Read the next sequential record from the host 
error log file 

Find the start of the next sequential record 
Format a system error log file record into 
hiiman readable form 

Search Routines 

Routines used to access the message template 
database (*. search files) » 



Delete an entire sestrch file 
Create a new search file 
20 Determine if a search file is empty 

Open a search file 

Generic routine to search for a matching 
search file entry 

Search for a matching ASCII record (use 
25 regular expressions} 

Search for a "matching system record (use 
message 'ID) "vl:^ 

Read the next sequential record from the 
search file ■■■^ 

00 Move read pointer to the start of the sezurch 

file 

Generic routine to add an entry to a search 
file ^ 
Add an ASCII search record to the end of a 
3s search file 

Add a system search record to the end of a 
search file 

• Add a new record to the end of the ^iearch file 
Sort all the records if the search file by 
40 message ID 

Look up a record in the search file based on 
message ID 

Change the contents of a specific search file 
record 

45 Delete a specific record from a search file 

Close a search file 
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"^Open a source ^ ■ - ■ ' - --'^ 

Generic routine to read the next sequential 
record from source 

Read the next sequential record from an ASCII 
" source 

Read the next sequential record from a system 
source 

Close a source 

'® 10, Verify Routines 

Routines used to check to RSF configuration files 
for errors* 
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Routine to check the validity of a host name 
Routine to check the validity of a tty 
Routine to check the validity of remote's 
publ ished password 

Rbutlne to check the callout configuration 
Routine to check the sburbe attriJbutes 
da€aifiase ' '"'"''^ '^-■■'■'^ -'^ -' "^/l- ■ ■ 

Routine to check daemon status 
Routine to check free space biti disKs 
Verify a specified subset of the above 

11. Config. Dlag. Routines 

Routines used to configure the diagnostic callout 
pcurameters. ■ .m-::-; ^ 

Routine to disable diagnostic calJ.outr-: : 
Routine to enable diagnostic caillout / v 
Routine to read diagnostic ' freguezicy' ^ 
Routine to write diagnostic freqiieiikcy 

12. KD Routines 

Routines used to manage daemon PID files (*«pid 
files) * V ; 

Create a PID file containing PID of caller 

Remove a PID file > . : 

Check ,the..st^t}^ a^PID-ilie- vu'r' - 

Scpd i jia^ tp a daeTOh (uses; PID file tP 
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- ~"«e-"ii-'-lw>i4--t.jn^^ ^ ' 

Date: Frl Apr 2 10:23:11 EST 1993 
Site Configuration 



call type: modem 
IS suptype: IICS2' 

aysid: tn>9999 

remote phone numbers; 
180055S2855 

^ ' opplione: (665) 555-3423 
opune: Jonathan 
mall J root 
ayaphona: 6655552331 
paasvd: phoenix 
tty: /dev/ttyO 

Terminal type that nnat be used for omllbaok: vtlOO 
Pull Text. of. Ke^sage^ 



ERROR LABEL: SDH ERRl 
ERROR ID: BAECC981 

Date/Time: . Frl Apr 2 10:23:08 

Sequence KUmber: 397433 

Machine Id: OD0004375C3A 

Node Id: ; hazel 

Error Class: H ' 

Error Typ^t PERM 

Resource Name: serdasdaO ^ 

Error Description 
MICROCODE PROGRAM ERROR 

Probable Causes 

STORAGE CONTROLLER KICROCODE 

Install Causes 

MISMATCT„BETHEENJG^RDWARE-AKD-J!XCROCOnE--^^^ 

HISHATCH BETWEEN SOFTWARE iliNO MICROaDbB 

\- Recpvmeniled ';X^ -''lUV;^ 
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PERFORM PROBZ£M DETERMHUTION PROCEDORES 



Detail Data 
SEHSE DATA 

OlFP OODO 0000 OOOO 0000 0000 0000 0000 



System Xtiformatlon 



OS Naae: BOSX 
OS Version: 3 
OS Release: 2 

Configuration Intoraation 
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rKSTAX«l£D RESOURCE LIST WITH VPD 

The following reeources are installed on your nachine. 
sysplanarO 00-00 CPU Planar 



Part Number 

EC Level « . * • . . ...... . . . . . V. . 

Processor Identification. . . . 

ROS liBVel and ID. . . • . . V. . . . . 

Processor Component ID. • . • • • 

Device Specific. (ZO) 

Device Specific. (21) ...... . . 

Device Specific. (Z2) 

Device Specific. (Z3) 

Device Specific. (Z4) 

Device Specific. (25) 

Device Specific. (26) 

Device Specific. (27) 

Device Specif ic. (Z8) 

Device Specific. (29) 

ROS £.evel and ID 

ROS Level and ID... 



043G1797 
00C74316 ^ - 
00000594 ■ 
IPLVERl.O 
LVLi;d2^043G2189 
0102006300006014 
012048 
021047 
031246 
041149 
CD234D 
ED234D 
0A114A 
2A114A 
4A114A 
6A114A 

OCS(07040AOO) 
SEEDS (FOBABCOl) 



ioplanarO 



00-00 



EC Level. 



busO 
sioO 



00-00 

Wis 



I/O Planar 
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Hicrodiannel Bus 
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- H^nttfa CT^er^ ; ; , .^^ .^tBMffTtr . ^ 

Diaplayable Message - .Sxi^DikD I/o 

Device Driver Level oo 

Diagnostic Level oo 

ROS Level and ID oooo 

Dlsplayable Message STANDARD SCSI 

Device Driver Level oo 

Diagnostic Level oo 

Loadable Microcode Level. .0044 

ROS Level and ID 0044 

Read/Write Register Ptr olOO 

^^^^ OO-OO-OD Standard 1/c 

Mn ^« ^ Diskette Adapter 

OO-OO-OD-00 Diskette Drive 

PPaO 00-OO^OP Standard l/o 

Parallel Port 
i«n - Adapter 

scSiO Sn^nrSr^^ Compuprint 4/51 

^^^^^ 00-00-OS Standard SCSI I/O 

K^^^UA ^ Controller 

hdiakO 00-OO-OS-OO 1.37 GB SCSI Disk 

Drive 

Device Specific. (ZO) 0000 

Manttracturer........... ibm 

Machine Type and Model .ST41600M 

Serial Number 00055744 

Device Specific* (Zl) . .70899604 

"""^^ OO-^OO-OS-IO CD-ROM Drive 

Device Specific. (ZO) 0580 

Manuracturer. TOSHIBA 

SrS^^r^L"^ ^"""^^^ CD-ROH DRIVErXM 

Kos ijevel and ID. 3232 

hdisfcl OO-OO-OS-20 1.37 CB SCSI Disk Drive 

Device specific. (ZO) oooo 

Manufacturer 

Machine Type and Model.... *.ST41600M 

Serial Hujuber 00073612 

Device Specific. (Zl) 70899604 

.r„to -^^-...^-^.-..-^^.-^ GB 8m Ti^lSi.,e 

■ ■^spiYite sp^i!!^ :':ioriio \ 



20 



30 



40 



SO 



-sao. :..^m^:MiJio=fi6=si^ 

oo-oo-si-oo f^iir^^ 

00-00-S2 Standard I/O 

ttyl 00-00-S2-00 SjJSrSSs' 

Controller 

Device Driver lAvel oo 

Diagnostic I«vel oo 

Dlsplayable Message scsi 

C74317 

FRtJ HvMber. . 31G9729 

Hanufactu^er. IBM97N 

Part Ronber 4301811 

Serial Number -?«*oxx 

Loadable Microcode Level* ' " *0044 

ROS Level and ID 0050 

Read/write jaegister Ptr.....0100 

hdislc2 00^01-00-00 1.37 GB SCSI Disk Drive 

Device Specific . (20) OOOO 

Manuracturer 13^, 

*fo<a«l- ST4i600H 

Serial Nunbei: 00073493 

Device Specific. (21) 70899604 

ento : 00-03 Ethernet High- 

Perfomance LAM 
Adapter 

^^^f-"^ M4*^ss 02608C2P9E82 

ROS Level and ID . iOOlS 

SS^SS^iv ^^^""^^ 802 . 3/BTaERllET 

Part Htober 000G3369 

^ ^""^II: C73859 
Device. Driver Level oi 

Diagnostic Level "01 

ran Nuaber. :000G33«8 

Serial Number oohqua 

Manufacturer [ ! 204491 

M^fn ^^'^^ - Xvas^Adaptftr 
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H ah u t a c bu rer .^mRmT6^9^ 

Pairt K\XBib«r 31G9393 

Serial , Kiziber 001114 

ROS Level : and ID 0000 

TO lioadable Kicrocode Level. ..,01 

fddil 00-07 FODl Prlaary Card, 

Dual Ring Fiber 

Network Address * . •100O5XB8054E 

Displayable Message FOOI RING B 

EC lisvel C73876 

FRa Htu&ber 81F9b03 

Hanuf actur er VEM68 5764 9 

Part Kmnber 3iG9393 

so Serial Vumber 00X069 

ROS I^vel and ID*. 0000 

Loadable Microcode Level. « . .01 
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fddixo 00-06 rbbi Extender Card 

sa2 00-08 16-Pprt Asynchronous 

Adapter EIA-422A 

Displayable Message lepORT RS422 

EC Level..* ••..«C2639€ 

FRU Kumber* .0302^297 

Manufacturer «... .veiip.857b49 

Part Htonber L.. 071F0976 

Serial Kumber 0013 29 

tty2 00-08-01-00 Asynchronous 

3s Terminal 

fpao 00-00 Floating Point 

Processor 

slco 00-00 Serial Optical 

Link Chip 

slcl 00-00 SexfiMl Optical 

Link Chip 

ioplanarl 00-10 l/o- Planar- 
EC Level FFFFFFPF 

bufil 00-10 Kicrbchannel Bus 

serdasdao 00-11 Serial-LinJc Disk 

Adapter 

J^a]^;, Nt^^ . i . 045G2774 

. v,4 ; V KJgeyi^i'iJ.f; 6i0i572O938 . 
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- — \ \ r ' : - ^ — .....■■^.-..p,::...^.^,-- ■ rt, ■ , 

serdasdcl 00-11-02 Serial-LinX Disk 

Controller 

Part KUmber 42G9575 

Serial Kumbar *.OO0C373S 

Xachine Type and Hcdel 9333-000 

Manufacturer ^ IBM -0053 

ROS Level and ID OC 

IS 

hdisk6 00-11-02-01 057MB F Serial- 

Link Disk Drive 

Part Number 95X2431 

£C Level... ...C79493 

^ Serial Number ^ • • . «Bia2136E ; 

Machine Type and Model 9333-100 

Manufacturer IBM -0902 

ROS Level and ID 63 

Device Specif ic. (Zl) 9103944 

as Device Specific* (Z2) 7102 = = 

Device Specific. (Z3) 7pF9042 

Device Specific. (Z4) 92087 

hdisk? 00-11-02-03 857MB F Serial- 

OT Link Disk Drive 

Fart Number 95X2431 

EC'jl^el. .079493 

SetriaLl' ;muDber B207056L 

Hachj^ and Model » 9333-100 

3S karmfactuz^er IBM -O902 

ROS I«vei and ID 52 

Devic^ Sj^^^ 910408S 

beVice Spi^cif ic. (Z2) • 5866 

Deyida Spj^if ic. (Z3) . , 76F9042 

^ Device Specific . (Z4 ) 92093 

serdasdcO 00-11-03 Serial-Link Disk 

Controller 

part Number 07G5194 

serial Number ....60002893 

Machine Type and Model. ... , .9333^000 

Manufacturer IBM -0053 

ROS Level and ID. OB 

so hdisk4 00-11-03-00 1.07GB F Serial* 
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Machine Type and Model 9333-110 

Manufacturer ♦ ihm -0902 

ROS Level and ID 63 

10 Device Specific, (Zl) 8203386 

Device specific. (Z2) 10959 

Device Specific. (Z3) 7OF9042 

Device Specific. (Z4) 92199 

,s ^^^^ 00-1^ Ethernet High- 

Performance lAH 
Adapter 

Network Address 02608C2F8A70 

ROS Level «md ID 0015 ^ 

20 Displayable Message 802. 3yETHERHET 

Part HuzDiber.. 00063369 

EC Level..... C73859 

Device Driver Level bl 

Diagnostiic Level ox 

^ FRU Humber. .. 00063368 

Serial Number 00114965 

Manufacturer. 204491 
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"P^O 00-15 4-Port Multi- 

protocol 
Connunications 
Controller 

"P<I0 00-15-00 Miatipto^^ 

Adapter Pbrt 

^P^^ 00-15-01 Muitlprotocbl 

35 Maypter iKort 

npq2 00-15-02 Muitiprotq«p 

Adapter Port 

«P^^ 00-15-03 KliltiprotOTO 

, Adapter Port 

40 ^^^^ 00-OB 64 MB Memory Carti 

Device Specific. (Z3) 07 

EC Level 21 

Device Specific. (ZO) oo 

Device Specific. (Zl) oo 

^ Device Specific. (Z2) oo 

Size... 64 

-OO-oe ~ ^4-MB"Hemdry Card 

60 t>wioe s 

EC Level* . . . ♦ 21 
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64 MB Memory Card 
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64 MB Memoxy Card 



siein2 OO-OD 

Device Specif ic, (23) 07 

EC Level 21 

Device Specific. (20) * ioo 

Device Specific. (Zl) oo 

Device Specific. (22) oo 

size 54 

iaeiii3 00 -OF 

Device Specific. (23) 07 

EC Level .•.ai 

Device Specific. (20) oo 

Device Specific. (21) oo 

Device Specific. (22) oo 

Size 54 

as OO-OG 64 MB Meaory Card 

Device Specific. (23) 07 

EC Level* 21 

Device Specific. (20) ..... . , loo 

Device Specif ic. (21) oo 

Device Specific. (Z2) oo 

Size 64 

oo-OH 6f4 MB Memory Card 

Device Specif ic. (23) 07 

EC Level 21 

Device Specific. (20) ! ! 1 00 

Device Specific. (21) oo 

Device Specific. (22) oo 

Size. 64 

sysunito oo-OO Bull DPX/20 System 

Unit 



so 
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aro in ]>old typa. 

Cluster Server Configuration 



calltype: modem 
suptype: RCS2 
sysid: aD9999 

remote phone numbers: 
18005552855 

opphone: (665) 555-3423 
opnaae: Jonathan S. 
mail; root 
sysphona: 6655552331 
paaavd: phoenix 
tty: /dev/ttyO 

Temiaal type that mnst be used for callback: vtlOO 
Date: Fri Apr 2 09:40:00 EST 1993 
Site Configuration 



Cluster Hoda Hama: fiver 

calltyi>e: network 
suptype: RCS2 
sysid: Ub9998 
opphona: (665) 555-3423 
opMtta: Jonathan S. 
mail: root 
passvd: bennu 
server: hazel 

Tarminal type that must be used for calllMck: vtlOO 
Full Text of Message 



ERROR lABEL: SRC 

ERROR ID: H18E984F 
Date/Time: Fri Apr 2 09:39:55 

Sequence Number: 1788031 

KachlTnuarrar ^"^ois^s^iTfs&io 
Node Id: fiver 

Erf<Hc''|^^ ■ s^r-r'' 
Error Tii^ie: PERM 




Probable Causes 
APPLICATIOK PROGBAM 

Failure Causas 
SOFTWARE PROGRAM 



Reconmended Actions 

PERFORM PROBLEM RECOVERY PROCEDORES 



Detail Data 
SYMPTOM CODE 
256 

SOFTWARE ERROR CODE 

-9035 
ERROR CODE 

0 

DETECTING MODULE 
"srchevn.c^eiine: *162^ 
FAILING HODOLE 
infod 

System Inforaation 



OS Name: BOSX 
OS Version; 3 
OS Release: 2 

configtucation Infpxnati^ 



INSTALLED RESOTOCE itS^^^ 

The folioving resources are installed on your machine. 

sysplemarO ! 00-^00 ■ COT Planar 

Part Number 043jS1797 

EC LevelV, , - 00C74316 

Processor Identification. . - . 00000594 

ROS Leyel and ID IPLVBRl.O 

LVL1.02,043G21S9 

Processor Component ID 0ip20p6300OO00l4 

Device Specific. (ZD) 012048 

r^^'J^'%^*|t«^ 

peyitee ASpecific^^^^^ ..... iv041^4i9 
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Device Specific. (29) 6A114A 

ROS Level and ID OCS(07040A00) 

HOS Level and ID SEEDS (FOBABCOl) 

10 ioplanarO OO-oo I/O Planar 

EC Level 39 

^^Y^o 00-00 MicroChannel Bus 

rs 00-00 Standard I/O Planar 

Part Number 52G1265 

EC Level •..•.D25842 

Serial Nunber 00000299 

FKD Kuiaber 52G1266 

20 Manu f actur er i BK97N 

Displayable Message STAKDARD I/O 

Device Driver Level OO 

Diagnostic Level oo 

ROS Level and ID «.0000 

25 Displayable Message STANDARD SCSI 

Device Driver Level oo 

Diagnostic Level 00 

Usadable Microcode Level. . . . 0044 

ROS Level and ID 0044 

^ Read/Hrlte Register Ptr 0100 

fdao 00-OO-OD Standard I/O DlsJtette Adapter 

fdO 00-oo-OD-OO Diskette Drlye 

ppao OO-OO-OP Standiird i/d Port 

Adapter 

35 Ipo oo*oo-op-oo Bull Conipuprint 4/51 

scslo Oo-oo-OS Standard SCSI l/o Cbiitrbller 

bdisko 00-K)0-OS-00 1.37 GB SCSI Disk Drive 
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Device Specific. (20) OOOO 

Manu ractiirer xwi 

Machine Type and Model ST41600N 

Serial Kumber. 0005S744 

Device Speblfic. (21) ...... . ,70899604 

00-GO-OS-lO CD-ROM Drive 

Device Specific. (20) 0580 

Memuf actiirer TOSHIBA 

M^chlTie7-Tyw^an^™Hc^ 
■ Leve|t^v;and: IDi ; ^ ; 1 1. ; ^^32^^^ "^- '^ '-"^i ■ 

hdlskl <^;0^af2^ 
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D<wi:e fe Sfwieif te- ( g ^-> > > /. . ; 7d tf!»^NM^ — 

rmto oo-OO-OS-50 2.3 GB Sua Tape Drive 

Device? Specific. (20) 0180 

Manxifacturerv EXABYTE 

Hachine Type sund Model EXBr8200 

^0 00-OPrSl Standard I/O Serial Port i 

ttyo 00*00-81-00 Asynchronous Terminal 

sal O0-00-S2 standard I/O Serial Port 2 

ttyl 00-00-52-00 Asynchronous Terminal 

scsil 00-01 SCSI 1/0 Controller 

Device Driver Level oo 

Diagnostic x^evel oo 

Displayable Massage SCSI 

EC Level. .... , ; . . » C74317 

FRXJ llU3n]t>^r. . . « , 31G9729 

Manufactarer^>> IBK97N 

Part in2mber.>>. 43G181X 

Serial Nunberi^ . . . . , . . . . v 
Loadable Microcode Level. • . . 0044 

POS Level and ID 0050 

Read/Write Register Ptr OlOO 

hdisk2 00-01-00-00 1.37 GB SCSI Disk Drive 

Device Speqif ic. (ZO) ........ OOOO 

Manufacturer; • IBM* 

Machine Type emd Model ST41600K 

Serial Number;. 00073493 

Device Specific. (21) 70899604 

«t0 00r^03 Ethernet Kigh- 

Perf onnance IAN 
Adapter 

HetvorK Address 02608C2F9E82 

ROS Level and ID 0015 

Displayable Message 802.3/ETHERNET 

Part Kttnber. OO0G3369 

EC Level C73859 

Device Driver Level 01 

-DiagncffiH|ieni^el-^ 

H»^^ . . ; d60G3368 

Mariufadt^^ ij^\txm^ . 



IS 



so 



Displayable Message fDDI RING B 

Eq I-evel \ C73876 

FRD NUttber 81F90Q3 

Manufacturer VEKj3 8 57 04 9 

Part Mumbaf 3109393 

Serial Kumber 001114 

ROS Level and ID OOOO 

Loadable Microcode Level.... 01 

fd^il 00-07 FDDI Priiaary card, 

DvlblL Ring Fiber 

Ketvork Address 10005AB8054E 

Oisplayable Message pdoi RING B 

EC Level. : .^73876 

FRU Number* . * . , aiF9bb3 

Manufacturer. VEK08S7049 

Part Number 31G9393 

Serial Number 001069 

25 ROS Level iUKl ID ooOO 

Loadable Microcode Level.... oi 

fddixO 00-06 FDDI Extender Card 

00-08 le-Port Asynchronous 

^ Adapter EIA-422A 

Displayable Message. 16P0RT RS422 

EC Level ; C26396 ■ 

FR0 Number 030F9297 

55 Manufacturer..; • .ven0857b49 

Part Number. - 071Fb976 

Serial Number ...001329 

tt:y2 00-08-01-00 Asynchronous Terminal 

fpao 00-00 Floating Point Processor 



slcO 00^00 
Slcl 00-00 



Serial Optical Link chip 
, , Serial Optical Link Chip 

ioplanarl 00-10 i/o Planar 



EC Level. 

45 



pFFFFFFFP 



^ 00-10 MicroChannel Bus 

serdasdao 00-11 Serial-Link Disk 



—r-r— — Adapter ^ -' ^ 

.KvHi. 1,^;/^;^-. ... ......... . ^-^,.^.:/:s^t!tjd^r-i: V} 

so Pairt NuDa:iSri:.iiiVi^^ Xo:^rs:v' 

Serial NuiBiBwl^^:.,... . , 
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Dlsplayable Message iSEWLI^ADAP^ 

sertasdcl O6-XI-02 Serial-LtnJc DisJc 

^0 controller 

Part Number 42G9575 

Serial Muaber. 00003738 

Kachine Typo and Model 9333*000 

,5 Manufacturer ibh -0053 

ROS X^evel and ID OC 

MlBks 00-11-02-01 a57MB F Serial- 

Link Disk Drive 

» Part Humber....... 95X2431 

EC Level.;. .....C79493 

Serial Number. BlSilSGE 

Machine Type and Model 9333-100 

Manufacturer. ; * ^ IBM ■ - -0902 

25 ROS Level and ZD ..63 • 

Device specific. (Zl) 9103944 

Device Sp^ecif ici (22) v. . . . . , -7103 ^ 

Device sp^if ic. (Z3) ....... .yoira'b^ 

Device Specific. (Z4) 92087 

30 \ . * 

hdisX7 00-11-02-03 857MB F Serial- 

LinJc Disk Drive 

Part Huiqiber. 95X2431 

as 2^ • > • C79493 

Serial Mtunber B207056L 

Machine vryp and Model 9333-100 

Manufacturer ibm -0902 

ROS Level and ID 52 

Device Speciiic.(Zl) 9104086 

Myice Specif ic. (Z2) 5866 

Device Specific. (Z3} 70F9042 

Device Specific. (Z4} 92093 

serdasdcO 00-11-03 Serial-LinJc Disk 

^ Controller 

Part Nxunber 07G5194 

Serial Number 00002893 

^P^ltoe-Type^atid McK^ 

GO Mamufactur^ , .IJMf -0053 

^ROS^^'LOTel^^a^^^ . . ^. v^Kl'^^-O^P^- ^ ^-^xv,.;- 



'^MM^'--' ■' . ^ ■ ■ ■■go?8544 
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10 



20 



SBrLaX Runber R012573V 

Machine Typo and Kodel 9333-110 

Kanuf a^urer ibm -0902 

ROS Level and ID 53 

Device Specific. (Zl) 8203386 

Device Specific. (Z2) 10959 

Device Specific. (23) 70F9d42 

Device Specif ic. (Z4) 92199 

« 00-14 Ethernet High- 

Perfonaance UN 
Adapter 

KetworJc Address 0260aC2F8A70 

ROS Level and ID 0015 

Displayable Message 802.3/ETHERNET 

Part Himber.. O0OG3369 

EC Level... .07 385? 

Device Driver Level 01 

Diagnostic Level oi 

2S PRD mmber.. 00063368 

Serial * Nuaber p6ll4 ? 65 . 

Manufacture...... 204491 r 

»Pqa0 00-15 4-Port Kiati- 

30 protocol 

Communications 
_^ Controller 
a^pqO 00-15-00 Mulltiprotocol 

Adapter Port 
mpql 00-15-01 Multiip^^ 

^^^^ 00-15-02 MdltipMtaTO 

Adaj^er Pbrt 

npq3 00-15-03 watiprotocol 

Adapter Port 

^e»0 00-OB 64 MB Merory Card 

Device Specific. (Z3) 07 

EC Level 21 

Device Specif ic. (ZO) OO 

Device Specific. (Zl) oo 

Device Specif ic. (Z2) 00 

Size 64 

— qo-OG r:rT^64-rMB"Memory-^C^^ 



35 



45 



60 Device Speci|ic . (Z 3 ) u 07 



65 



96 
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EC Level, . . 

T>e^/imB S^^^ ... .V i tJ6 

Beyice Specific. (21) . ...... 

Device Sp^<3ific^ . . . . . , . . pfl _ 

00-OD 64 KB Memory Card 

Device Specific. (Z3) 07 

EC Level 21 

Device Specific. (ZO) oo 

Device Specif ic. (Zl) oo 

Device Specific. (22) oo 

Size 64 

64 MB Memory Card 

Device Specif ic. (23) 07 

EC Level 21 

Device Specif ic. (20) oo 

Device Specific. (21) oo 

Device Specific. (22) oo 

Size 64 

64 MB Memory Card 

Device Specif ic.^(23) 07 

EC Level .21 

Device specific. (20) op 

Device Specif ic. (21) bp 

Device Specific . ( 22 ) oO 

Size ...64 

00-OH 64 MB Memory Card 

Device Specific . ( 23 ) 07 

EC Level. 21 

Device Specific (20) ...... . . oo 

Device Specific. (21) ....... .00 

Device Specif ic. (22) oo 

Size .i.., ......64 

sysunito 00-00 Bull DPV20 Systeia 

Unit 



Successful callout to response center: Kon Mar 15 
14:57:19 EST 1993 

The reason for the callout is as follows: 



ERROR IABEL: 
ERROR ID: 



L10N_BUFF£R0 
50CA5315 



Date/Time: 
Sequence Number: 
Hadilne Id: 
Mode Id: 
Error Class: 
Error Type: 
Resource Kane: 



Thu Mar 11 14:15:08 
95740 

000006706300 

onion 

S 

TEMP 
tty3/0 



Error Description 

Buffer overrun: 64 port concentrator 

Failure Causes 

EXCESSIVE LOAD ON PROCESSOR 

Recommended Actions 

Reduce system load 

Reduce serial port baud rate 



Motes: 

If an E-mail address Is configured, E-mail such as the 
above example will be sent to the specified address 
whenever a callout pccurs. 

If it is desired to send E-mail notification to several 
people at once, then an E-mail alias is used. 



It will be apparent to those sWHed In the art that many changes may be made to the preferred 
emtjodiment of the present Inventkm. For example, while a UNIX based host computer system was shown 
as utilizing the present Invention to provide remote support the present invention may be used on other 
system~p^tfp^ 

/form^^ittw 

.fo(jEh;>lfTii!|» oert^h^'lMftS?^ 

adlran^ w " ^^^^ , . • 

Cl^mST~:' r ^,„,_„„. . . ^ ,. 

1. A pi s^gaxn^^ arid operating a proactive arid reacth/eA rerrwie services facility <RSF) unit 

instaH^db^ a host systerri s which is operatiyely connected to cprnmunicate with a remote response 
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center decfical^ to support services for said host system Involving diagnosis of fiost 

system iiwbtenS^^^ : v v ; . 

■''■'^^^ 

component t>y estabJishrng predeterimlned parameters defihtng how said each component is to 
perform saki one of said numt)er of baste functions )n carrying out remote support; and. 

(c) integrating said numl>er of software components togetfwr in a predetermined rnanher so that said 
10 components collectivety perfoon said proactive and reactive renriote support according to said 

predetermined parameters preconflgured In step (b). 

2. The metfwd oif cfaJin 1 wherein sakJ fwst system includes a host compoter, an UNIX l)ased operating 
system for controlling ttie operation of said host computer, a genertc menu interface system (GMIS) 
IS unit for communicating with said operating system using menu Initiated dialog sequences and a display 
terminal unit operatively coupled to s^ host computer and to said Gf^lS unit for enabFing a user to 
enter commands directly or tfuougfi said GMIS unit for execution by said RSF unit* said method further 
compri^ng ttie steps of: 

(d) operatively coupling each of said number of software components to said GMIS unit; and» 

20 (e) inchiding witWn each of said numl)GFr of components, a number of modules wfwch operafively 

couple to ssSd GMIS linit, said number of modules being' responsive to a different predetenmlned 
command sol containing a smail number of commands customized for configuriftg said each of said 
components according to step (b). 

25 3. The method of claim 2 where&i said computer system includes a numt)er of source enor log files used 
by ScOd host computer for togging errors encountered wWte running appflcations oh said host computer 
and wherein said remotely kx^led response centcn' perfonns supjfx^^^^^ for said host system by 
calEng back into said twst sy^e^^^ in respot^ to a first c^pKX^ numSor of components 

having detected ah bveiiir^fioid^^c^ which caused a <^W'8(^on to foe made by said RSF unit 

M for further dlagnosils and correctionof a system prot>lein reported by said host systam, said first 
component rndudihg said nurhber of kkurce^^^^ and a control atirlbute isie ar>d wtierein said 

step (b) of said method further includes the steps of: 

(f) configuifng each of sad nurnber of source Wor log files to t»'rndnftored by causing storage of a 
source record entry In s^d coatrol fite to^ said numlief of sbiice log fites to be nwnltored, 

35 said reconi entry cohtainfrig a unique user spchcified narne for said log file, a path name to said log 

file, infotma^ibn idonlifyirHj the type of tog Gle, b:tormati6ci iderttifyirig how oftan to scan for new 
messages arxf infonnatf^ what ribtification action to jnv^ a message ts detected by 

s^d first component M beirig ow^ 

(g) initiating said notification actton specified by sakJ souribe' record entry to said response center 
40 upon detecting an occurrence of an overtfireshold cooiiftlon withiri'said source. 

4. The method of claim 1 wherein said number of components of said RSF unit are included within a 
predetermined number of subpackages, said predetermined number of subpackages Including a 
problem detection and reaction subpacfcage, a system action subpackage« a callback subpackage and a 
4s cluster subpackage and wherein said method further InckJdes the step of: 

sefectively loading predetermined ones of said predetermined number of sut>packages as a 
function of how said host system lias iToen configured to operate. 
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a number of IndeperK^^^ TOftwar e eadii^comfM^^ constructed for 

■ v v..; i^Rarfwrnlngf^^^^ . . 

^' ^^' .r ^^ _ _ ^ . 

said one of said number of basic functions In carrying out remote support and. 

means for Integrating said number of software components together in a predetermined manner so 
tfiat seud components collectively pedorm said proactive and reactive remote support according to said 
predetermined parameters. 

JO 

7. The RSF unit of claim 6 wherein said host system lr)ciudes a host computer, an UNIX based operating 
system for controlling the operatfoo of said host computer, a generic menu Interface system (GMiS) 
unit for communicating with said operating system using menu initiated dalog^uences and a display 
temninal unit operatiyely coupled to said host computer and to said GMIS unit for enabling a user to 
75 enter comnuinds directly or through said GMIS unit for execution by said ftSF unit, said RSF unit 
further comprising: 

means operath/ely coupling each of said rutmber of software components to GMIS unit; and, 
each of said nurnber of components furttier including a numt>ef of modules which operativefy 
couple to said GMIS unit, said number of modules being responsive to a different predetermtned 
20 command set containing a smalt number of commands custcmiized for conffgudng said each of said 
components. 

d. The RSF unit of claim 7 wf>eretn said iiost computer further Includes utiGty and appPicatlon program- 
ming means for togging errors encountered white running on said ^host computer and wherein said 

25 remotely located responsa center performs suppprt services for said host system by calling back Into 

said host system In response to a first compqfient of said numt)er of components having detected an 1 
oyerthreshold corKlition which caused a callout actiori to be made by said P&F unit for further diagnosis { 
and conrectfon of a system problem repofted by said host system, said first componait further 
Including: ' _[ ■ ' . ./ ' ■ • 

30 a number of source error log files used by said f^ogramming means for logging said errx>rs and a 

control attrft>ute file; ' . 

rneans for configuring eaph of said number of source enror log files to be nnofiitored, said means for 
configuring causing Sftprage of a source record entry in said control file for e^ of said number of 
source, log files to be monitored, said record entry containing a urUc;|ue user spedfied^name for said log 

35 file, a path name to said log file. Infonmation Identifying the type of tog fite. Information Identifying how 
often to scan for new rnessages and informatipn designating what notification action to invoke if a 
message Is detected by sakl first component as t)etng pverttveshpid: and; 

means for ii^tlating sakl notification action specified by s^d source, record entry lo said response 
center upon detecting an occurrence of an overtiveshold condition wittiln sjjd source. 

40 
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Record of actions for source "system' 




/usr/bin/callact 
UNSUCCESSFUL (1) 



ACTION: 
RESULT: 
OUTPUT: 

Performing Callout: Thu Apr 1 14:26:30 EST 1993 
Error: Invalid message identifier 
Speclfleci ID is not a hexadecial nuit^r: hazel 
Date: Thu Apr 1 14:56:05 1993 
ACTION.' /usr/bin/mailact 
RESULTS SUCCESSFUL 
OUTPUT 

Date: Pri Apr 2 12:53:26 1993 
ACTION: 
RESULT: 
OUTPUT: 

Performing Callout: Fri Apr 2 
Successfully queued callout 
Date: Fri Apr 2 12:53:26 1993 
ACTION: /usr/bin/mailact 
RESULT-. SUCCESSFUL 
OUTPUT: 



Pri Apr 2 12:53:26 
/usr/bin/callact 
SUCCESSFUL • . 



12:53:19 EST 



\ Da 

\ac 

RE 



f Record of actions on behalf of cluster nodes 



XDater Thu Apr 1 15:36il3 1993 
VACTldMt /usr/bin/netcall 
[RESULT: SUCCESSFUL 
/OUTPUT: 

/ Callout on behalf of cluster node fiver 
/ Successfully sent message to BRC 
/ Cufitcvner Service Request Nuniber: 2092392a 
/ Dates Thu Apr 1 1*5: 39; 56 1993 
/ ACTION; /usr/bin/netcall 
( RESULT: 
I OUTPUT: 



SUCCESSFUL 



Callout on behalf of cluster node thayli 
Successfully sent message to BRC 
Customer Service Request Number: 20823929 
Date: Thu Apr 1 15:47:17 1993 
ACTION: /usr/bin/netcall 
RjaSULT: SUCCESSFUL 
^OUTPUT; 

Callout on behalf of cluster node hyzenthlay 
Successfully sent message to BRC 
^Customer Service Requesjt Number: 20823930 



FIG. 5c 



110 



C098558 




Source Message Database 
Part of meed 



Stored Message 1 



Stored Uessage 2 



Stored Uessage 3 



Stored Ueeeage 4 



Stored llesiuge 5 




Stored Messiage 6 



^{SloredMessagoh:}' 




ID: 


IDof nralchtngj^ 


Time Stamp: 




BcplmtlonDate: 


When the message exf^res 


Length of Message: 


Length of tl^ field 


Message Held: 


The rnes^ge data 







F16. 5d 
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ID LABEL 

-f — f 



TYPE CLASS ERROR DESCRIFTION 



^0«530£A6 

019125F9 

022S8DD6 
0260B082 

02^FOOfi 
0375DFC2 
Q38FZ580 
a38F31l7 
03ACD15Z 
429B097 
ICSCO 



DMA^ERR 0NKN H UNDETERMINED ERROR 

LANOUO Temp 5 SOFTWARE PROGRAM ERROR 

LOO.CociTOp PERM S CONFIGURATION OR CUSTOMIZATIOK ERROR 

LAN80IE Tanp S SOFTWARE PROGRAM ERROR 

X25.ALERT2 PERM H X*25 RESTART REQUEST BY X.25 ADAPTER 

LANSKC Penn S SOClSVARK ntOGRAM ERROR 

SDLftOOE PERM S SOFTWARE PROGRAM ERROR 

SDUOID PERM S SOFTWARE PROGRAM ERROR 

PDDI.NOMBU TEMP S RESOimCB UNAVAILABLE ERROR 

X25_ALERT5 TEMP H X-SnUME TYPE W RECEIVED 

SCSI.ERR7 UNKN H UNDETERMINED ERROR 

MPQPJ>SRDR miP H COMMUNICATION PROTOCOL ERROR 

NB2* PERM S SOFnVARE PROGRAM ERROR 

LAN(MS3 Perm S SOFTWARE PROGRAM ERROR 

VCA^INTTZ TEMP S Host uidependent ihiUaliztd'on failed 

SCSI.ERRl PER^f H ADAPTER ERROR 

SDLW14 miP S SdrrWAJi: PROGRAM ERROR 

MEM2 PERKf H Memory fanm 

CFG^BU PERM S Conficunaon Evufod*^d but typo 



SYSTEM LOG JTLB 



f Jua 23 D8:54:5l TP^lnlt: Caa^l allocate naemory for linrt lOPB 
Juo 23 13:02:42 Feedback from MVU-MS does not tndicale movement 
Jud 23 13:02:4<^ ControUer retries attempted before command completed 
Jun 23 13:02:46^ Can't allocate message buffer 
Jua 23 13:02:51 Dieikl (odd) count 5|?^!flcd in S/G list 
Jun 23 13:03:51 Video signal mls^g from TP module 2 
Jun 23 13HKt:55 Camiot sUrt molo (4:2): faii, sense key b 0x2231 
Jua 23 13:02(55 Caimot activate MVU 4 of 2 
Jun 23 13:03:57 Audio signal nitlsi^g from TP mo^ble 2 
Jun 23 13:03:59 Status rcg 0x02, Bank 0x0003» Syndrome OxFFFF. err on TP 2 
Jun 23 13:05:00 Can't nush/unmap unit structure 
Jun 23 13:05:00 Address not mapped properly 
Jun 23 13:05:01 Can't dump more than 512 MB physical memory 



ASCnLOGHLE 



0(30: SAMPl£ SEQUENCE OF RSF CONFIGURATION STEPS 



Install 



001 



Configure An 
ASCII Source 

FIg.Tc 002 

UEZ 



Configure a 

System Source 
Flg.Tc 003 



i 



Configure 

CaKout 
FJg.7d»7e 004 



1 



Conflgure 
Callback 
Fl9.7f»79 005 




— From GUIS UnK 
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cmfln(Loc*LMooEUir 



OlSPLW SUBUEHI Wm 
SRE nUWCERSk 
UQDOl FMWGOIS 
jWCWjff TIHNB 



-755 



nk Be 



I 



Douir sueuEMj Mm y 

SET SUSEH DOOFCIC^ 

AK> OIHER SnE - 
RmMglDB«SHOW 



7S6 



✓-758 



F16, 7« 
'760 



OSFUUr 9JGUEMI VffH 
UST RC mOC JUSER. 
M» nc HOE WBDt. 

* DEi£fE A Rc mac 

NUWBER SHCMN 



'752 



fIGLAg 



764 



HGLflh 



eWER BOC WJUGER RK R& 




a«K OUTTO M 'SHE /' 



SEim 'OIHER SIE r |K a 



774 



O0ER OPERimiR NMe CFDWOR 
PHONE HUUQEa SKSIDI IWC 



m OUrW 'CONFlGURtf^ 



778 



IRSFllOCQjV Y 

^MQoop/ Oona 7©) 

^R 

{ID Ra 7d2) 



RGi 7dl 
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ON FROM FIG. 7d1)- 



UVMGQGa'SGQUENCE 



(Mf«XJnG.7dl)- 



832 



ospixr SUBMENU wm usr 

QUQO GAUOUIS; SHM 
AQUBH>OimiV 



8U 



saET tWNEX/SHOff 

ouoir IMWZR sDuusr 



B36 



emCR DQAT BEHKBI OtlOiTS 
AND IMXniUy QUEUE UMR 
EXBCUIEOMIX; 



MwwBt wool'' 



'839 



DMLiC ASKS "NOC AT SVSmi 
fSBOQT OR BQQH?' , SaOT BOflH 
W E3CflffE OAtflG 



otuoff (cQisiR cuEwlf 



8S0 



<• 

Dcspuar SUBMENU wH scrj ^ ^ 

SYStEM DOnra AND 
SEX CmR nKMBOS 



054 




✓-856 



6SB 



OOGR OFDWDR kmc: 
OPERITO PHONE N UMBER 
RBIIKt msSKXD^ 
CUSIERSQAIRANDOM. 
ADCVCSS; DECUE 
PWiOC 



FIG. 7d3 



FIG. 7d4 
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■900 



J r 

IPERPQRM CMifliari 

"J ^902 



nsafir A SUGiSNU «nH OOKFKURE 



FIG. 9a 



ISaKT ■OOffBURE PtMSaOHS' I FB. 9b 




SET 'KUOIE SERMCE DNHN* 
10 BEKSttED 




912 



SET 'REMOIE SERWX DM.-M* 
TO BEEWaiP 



T 



so 'AUM ROOT FRMfiGOr 
TP YES^ BtEOnE DWlOe 

i 009 

^ 



SET 'AUOif ROOf i>RM(£CE^I/ 



,918 



1 nc* 
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iPtRPORU ^OOHFlGlJfC 




920-6 



SET "SESSION NOmonON 
IKIERMnNE' 10 NO 




920-10 



N r920-12 



ISET "SESSW LQOGINf ^ 




SET 'EHAOEEIMLCM 



920-24 



ENTER 'TDaOW. TYPE FOR 
OttJLBttK* , PCEOJIE DWLQG 



92M 



SET *5ESSI0H NOnFX^nON 
WOmiVE' ID YES 



tPBiRWW 'NOnFKXBON DEMCE'l 



I 



[SET 'SESSPW [fleOWG' ID YES | 



920-tB 



SET 'ENAOE EMAB. ON 
OtHN*TO1fES 



\Qm 'OWL /OORESS'I 
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T 

I PERFORM VdlMBn 



osnxr A SU8UQU wim SHOW rsf 

SUIUSk SMTT iSF DttMOIt. 



FK. 10a 



934 



SEUCT tOfROURE DVCHOSOC HG. IQb 




SET rnOf DMSNOSnC TO NO. 
EXECUIE DWJ06 



- HSET "EWM^ DWGHOSnC TP Ys] 



RG. 7h 
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CSWRT, 



IPERPDW 




I 



OSPI/Y A SIOIENU WIH SHOW RSF 
STAIUS. START RSF DAEMON..- 



na 10a 



IsaECT •SlWr RSF CABIOH' 



E 



OALOG ASKS 'Wnr. AT SYSTEM. 
REBOOT OR BOIH?^ . SEUCT eGW 
AND EXECUTE DHLDC 





F)6. 10b 



960 



[SEIECT 'START OlSIER MEMOK't FK 



DIAU3G ASKS 'NOW. AT SVSIEM 
REBOOT OR 80IN?*, SELECT BOm 
AND EXECUTE OWXX: 



FIG. 71 



EP 0 632 382 Al 



?r«ii!<^ :Cat«r -AF^Qt ^iiiiki^ ^ . 



* IHPtrr d«vlc» / dixme tiorY foe xof t:ii«r« 

COHHIT «oftv«c«7 
SAVE r«plao*a £i.l«97 
VEaxnr fott^mrm? 

EXTEM) «YKt:«B« If ffp»e« nodded? 

bEMOVE input Cll* Aftttr ln«tAllatlaii7 



Esc-fr9«Sli«ll 



Esc 4 6^owi«od 
Esc+OwEkIc 



Exc^y-Edlt 
Ent«T«Oo 



no 



(Entrr Timldml 



Exo^iwZmKg* 



FIG. 6a 



Xn*taiX Software Wltli U^«i«« 



90FTWABE to install 
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